Menu
Setup dosu MCP and linux-mcp-server for Bluefin maintainers
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/castrojo/bluespeed --skill bluespeed-onboardingThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Based on SOC occupation classification
| name | bluespeed-onboarding |
| description | Setup dosu MCP and linux-mcp-server for Bluefin maintainers |
Automated setup of MCP servers for Project Bluefin maintainers using AI coding tools (OpenCode/Goose).
This skill should be invoked when:
Configures AI tools with the following MCP servers:
The following packages are required and will be auto-installed if missing:
# JSON/YAML manipulation (Required)
brew install jq
brew install yq
# MCP Servers (Required)
brew install ublue-os/tap/linux-mcp-server
Homebrew must be installed - skill will fail fast if missing. Install from: https://brew.sh
When an agent executes this skill, follow these steps inline using the Bash tool. Do NOT clone this repository or run bash scripts - execute commands directly.
if ! command -v brew &>/dev/null; then
echo "ERROR: Homebrew is not installed. Install from: https://brew.sh"
exit 1
fi
if ! command -v jq &>/dev/null; then
echo "Installing jq..."
brew install jq
# Verify installation
if ! command -v jq &>/dev/null; then
echo "ERROR: jq installation failed"
exit 1
fi
fi
if ! command -v yq &>/dev/null; then
echo "Installing yq..."
brew install yq
# Verify installation
if ! command -v yq &>/dev/null; then
echo "ERROR: yq installation failed"
exit 1
fi
fi
if [[ ! -f /home/linuxbrew/.linuxbrew/bin/linux-mcp-server ]]; then
echo "Installing linux-mcp-server..."
brew install ublue-os/tap/linux-mcp-server
# Verify installation
if [[ ! -f /home/linuxbrew/.linuxbrew/bin/linux-mcp-server ]]; then
echo "ERROR: linux-mcp-server installation failed"
exit 1
fi
fi
USERNAME=$(whoami)
echo "Detected username: $USERNAME"
OPENCODE_CONFIG="$HOME/.config/opencode/opencode.json"
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S")
# Create config directory if needed
mkdir -p "$HOME/.config/opencode"
# Create default config if missing
if [[ ! -f "$OPENCODE_CONFIG" ]]; then
echo '{"mcp":{}}' | jq '.' > "$OPENCODE_CONFIG"
echo "Created default OpenCode config"
fi
# Backup existing config
BACKUP_PATH="${OPENCODE_CONFIG}.${TIMESTAMP}.backup"
cp "$OPENCODE_CONFIG" "$BACKUP_PATH"
echo "Backup created: $BACKUP_PATH"
# Check if dosu already exists
if jq -e '.mcp.dosu' "$OPENCODE_CONFIG" >/dev/null 2>&1; then
echo "WARNING: dosu MCP already configured, skipping..."
else
# Merge dosu configuration
jq '.mcp.dosu = {
"type": "remote",
"url": "https://api.dosu.dev/v1/mcp",
"headers": {
"X-Deployment-ID": "83775020-c22e-485a-a222-987b2f5a3823"
}
}' "$OPENCODE_CONFIG" > "${OPENCODE_CONFIG}.tmp"
mv "${OPENCODE_CONFIG}.tmp" "$OPENCODE_CONFIG"
echo "SUCCESS: Added dosu MCP configuration"
fi
# Check if linux-mcp-server already exists
if jq -e '.mcp."linux-mcp-server"' "$OPENCODE_CONFIG" >/dev/null 2>&1; then
echo "WARNING: linux-mcp-server already configured, skipping..."
else
# Merge linux-mcp-server configuration
jq --arg user "$USERNAME" '.mcp."linux-mcp-server" = {
"type": "stdio",
"command": "/home/linuxbrew/.linuxbrew/bin/linux-mcp-server",
"env": {
"LINUX_MCP_USER": $user
}
}' "$OPENCODE_CONFIG" > "${OPENCODE_CONFIG}.tmp"
mv "${OPENCODE_CONFIG}.tmp" "$OPENCODE_CONFIG"
echo "SUCCESS: Added linux-mcp-server configuration (user: $USERNAME)"
fi
# Validate final configuration
if jq empty "$OPENCODE_CONFIG" 2>/dev/null; then
echo "SUCCESS: JSON validation passed"
else
echo "ERROR: JSON validation failed, restoring backup..."
cp "$BACKUP_PATH" "$OPENCODE_CONFIG"
exit 1
fi
After successful configuration, tell the user:
✓ OpenCode configuration complete!
Next steps:
1. Close all OpenCode windows
2. Restart OpenCode from application menu or 'opencode' command
3. Verify MCP servers loaded: Check "MCP Servers" panel in sidebar
4. Test: Ask "Can you check my system information?" (tests linux-mcp-server)
Troubleshooting:
- Logs: ~/.config/opencode/logs/
- Config: ~/.config/opencode/opencode.json
- Backup: [backup path from step 6]
If the user also wants to configure Goose, follow similar steps:
GOOSE_CONFIG="$HOME/.config/goose/config.yaml"
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S")
# Create config directory if needed
mkdir -p "$HOME/.config/goose"
# Create default config if missing
if [[ ! -f "$GOOSE_CONFIG" ]]; then
echo 'extensions: []' > "$GOOSE_CONFIG"
echo "Created default Goose config"
fi
# Backup existing config
BACKUP_PATH="${GOOSE_CONFIG}.${TIMESTAMP}.backup"
cp "$GOOSE_CONFIG" "$BACKUP_PATH"
echo "Backup created: $BACKUP_PATH"
# Check if linux-mcp-server extension already exists
if yq eval '.extensions[] | select(.name == "linux-mcp-server")' "$GOOSE_CONFIG" 2>/dev/null | grep -q linux-mcp-server; then
echo "WARNING: linux-mcp-server extension already configured, skipping..."
else
# Merge linux-mcp-server extension
yq eval ".extensions += [{
\"name\": \"linux-mcp-server\",
\"type\": \"stdio\",
\"command\": \"/home/linuxbrew/.linuxbrew/bin/linux-mcp-server\",
\"env\": {
\"LINUX_MCP_USER\": \"$USERNAME\"
}
}]" "$GOOSE_CONFIG" > "${GOOSE_CONFIG}.tmp"
mv "${GOOSE_CONFIG}.tmp" "$GOOSE_CONFIG"
echo "SUCCESS: Added linux-mcp-server extension (user: $USERNAME)"
fi
echo "NOTE: Phase 4 TODO - dosu MCP support for Goose pending research"
# Validate final configuration
if yq eval '.' "$GOOSE_CONFIG" >/dev/null 2>&1; then
echo "SUCCESS: YAML validation passed"
else
echo "ERROR: YAML validation failed, restoring backup..."
cp "$BACKUP_PATH" "$GOOSE_CONFIG"
exit 1
fi
✓ Goose configuration complete!
Next steps:
1. Exit Goose session: 'exit' command or Ctrl+D
2. Restart Goose from terminal: 'goose'
3. Verify extensions: Check startup messages for 'linux-mcp-server' loading
4. Test: Ask "Can you check my disk usage?" (tests linux-mcp-server)
Note: dosu MCP support for Goose is planned for Phase 4
Troubleshooting:
- Logs: ~/.config/goose/logs/
- Config: ~/.config/goose/config.yaml
- Backup: [backup path from Goose step 1]
If any step fails:
Example error message:
ERROR: linux-mcp-server installation failed
To fix:
1. Check Homebrew tap: brew tap ublue-os/tap
2. Try manual install: brew install ublue-os/tap/linux-mcp-server
3. Verify installation: ls /home/linuxbrew/.linuxbrew/bin/linux-mcp-server
4. Re-run this skill after fixing
Your config has been restored from backup: [backup path]
After executing this skill successfully:
Bash reference scripts are available in scripts/ directory:
scripts/bluespeed-onboarding.sh - Main entry point (interactive mode)scripts/setup-opencode.sh - OpenCode-specific setupscripts/setup-goose.sh - Goose-specific setupThese scripts implement the same logic as this SKILL.md for manual execution.
83775020-c22e-485a-a222-987b2f5a3823https://api.dosu.dev/v1/mcpX-Deployment-ID header (public identifier)/home/linuxbrew/.linuxbrew/bin/linux-mcp-serverLINUX_MCP_USER (set to current username)brew install ublue-os/tap/linux-mcp-serverPlanned improvements: