Skip to content

feat: add launchd service management and agent skill install#1

Open
dazuiba wants to merge 2 commits intopetergam:mainfrom
dazuiba:feat/launchd-service-and-skill
Open

feat: add launchd service management and agent skill install#1
dazuiba wants to merge 2 commits intopetergam:mainfrom
dazuiba:feat/launchd-service-and-skill

Conversation

@dazuiba
Copy link

@dazuiba dazuiba commented Mar 5, 2026

Summary

  • Add xcode-mcp service commands (install/uninstall/status/logs) to run the bridge as a persistent macOS launchd daemon — auto-starts on login, auto-restarts on crash, zero extra dependencies (no pm2 needed)
  • Add xcode-mcp skill install --skill-root-dir <path> to copy a bundled SKILL.md into Claude Code (~/.claude/skills) or Codex (~/.codex/skills) directories, so agents learn the CLI without loading all 20 MCP tool definitions into context
  • Ship skills/xcode-mcp/SKILL.md with the npm package (added explicit files field to package.json)

New commands

# Daemon management (launchd)
xcode-mcp service install      # generate plist + launchctl bootstrap
xcode-mcp service uninstall    # launchctl bootout + remove plist
xcode-mcp service status       # check loaded/running + /health
xcode-mcp service logs [-f]    # tail ~/Library/Logs/xcode-mcp-bridge.*.log

# Skill management
xcode-mcp skill install --skill-root-dir ~/.claude/skills
xcode-mcp skill uninstall --skill-root-dir ~/.claude/skills

Test plan

  • npm test — all 16 existing tests pass
  • xcode-mcp --help — new service and skill commands visible in correct order
  • xcode-mcp service --help / xcode-mcp skill --help — subcommands render correctly
  • xcode-mcp skill install --skill-root-dir /tmp/test — copies SKILL.md successfully
  • xcode-mcp service install — plist appears in ~/Library/LaunchAgents/, bridge starts (requires Xcode 26.3)
  • xcode-mcp service status — reports running + healthy
  • xcode-mcp service uninstall — cleans up plist and stops process

🤖 Generated with Claude Code

dazuiba and others added 2 commits March 5, 2026 10:39
Add `xcode-mcp service` commands (install/uninstall/status/logs) to run
the bridge as a persistent macOS launchd daemon with auto-start on login
and auto-restart on crash — replacing the need for pm2.

Add `xcode-mcp skill install --skill-root-dir <path>` to copy the bundled
SKILL.md into Claude Code or Codex skill directories, so agents learn
how to use the CLI without loading 20 MCP tool definitions into context.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant