Installation
devcoach runs locally — a stdio MCP server that stores everything in ~/.devcoach/coaching.db on the
machine where your agent runs. It works in Claude Code and Claude Desktop, but not on claude.ai
web (which only supports hosted/remote connectors — see Privacy & security).
Requires Node.js ≥ 24.
Which method is right for you?
devcoach works the same whichever way you install it — pick by how you like to work:
- Developer, comfortable in a terminal → Homebrew (macOS / Linux). One
brew installsets up devcoach and thedevcoachCLI, so you also get the command line and can launch the dashboard with a baredevcoach ui. (On Windows, or if you prefer npm, npx / npm is the equivalent.) - Prefer the simplest, no-terminal setup → the Claude Code plugin (Beta)
(one-click from the marketplace) or, on Claude Desktop, the
.mcpbextension (Beta). Nothing to configure — install and go. (These don't add thedevcoachCLI; run CLI commands withnpx -y devcoach …if you ever need them. For the most stable experience, use Homebrew or npm.)
All methods
| Method | Best for | Terminal? | Status |
|---|---|---|---|
| Homebrew | Developers on macOS / Linux who use the CLI | Yes | Stable |
| npx / npm CLI | Any MCP agent · Windows · npm workflows | Yes | Stable |
| Claude Code plugin | Non-expert Claude Code users — one-click setup | No | Beta |
Claude Desktop (.mcpb) | Non-expert Claude Desktop users — one-click setup | No | Beta |
| Other MCP agents | Cursor, Windsurf, Cline, Continue, Zed | Yes | Beta |
| claude.ai web | claude.ai (skill-only, no MCP) | — | Beta |
Each page below is self-contained: it covers install and connect.
→ Next: once installed, head to Coaching in your agent for onboarding and your first lesson.