agentbrew

One config, every agent — and it stays in sync automatically. AgentBrew deploys skills, MCP servers, rules, and commands across 43 AI coding agents and runs a background drift repair every 30 minutes to catch and fix any divergence.

npx agentbrew init

Every AI coding agent wants its own config — CLAUDE.md, Cursor rules, Windsurf workflows, MCP server JSON, slash commands. Most tools sync once and drift. AgentBrew self-heals.

1. Self-heals — background scheduler detects drift and auto-repairs every 30 minutes (macOS: LaunchAgent; Linux: systemd/cron)
2. Syncs MCP servers, rules, commands, and skills to every agent in its native format
3. Catalogs 114 skills, 15 MCP servers, 5 rule sets — install with one command
4. Teams — share config via a git repo; new hires get everything in one command

Quick Start

npx agentbrew init                   # detect agents, discover config, install drift repair
npx agentbrew install --recommended  # install curated skills + MCP servers + rules
npx agentbrew sync                   # deploy everything to all agents

Or install globally: npm i -g agentbrew. After init, drift repair runs in the background. You're done.

CLI Reference

agentbrew --help shows the 15 core commands. Use agentbrew --help-all to see all commands.

Core

agentbrew init [--force]              Detect agents, discover config, set up drift repair
agentbrew status [--json]             Show agents, MCP servers, sources, and skills
agentbrew sync [--only mcp,skills]    Deploy MCP servers, rules, commands, skills to all agents
agentbrew check|doctor [--no-fix] [--ci]  Detect drift, broken symlinks, skill validity; auto-repair

Install & Update

agentbrew catalog [--search <term>]   Browse skills, MCP servers, and rules
agentbrew install <name>              Install from catalog or any added source
agentbrew install --recommended       Install the curated starter set
agentbrew add <source>                Add a GitHub repo or local folder as a source
agentbrew update                      Pull latest from all sources, re-sync
agentbrew remove <name>               Remove an MCP server or source (auto-detects type)

Config

agentbrew mcp add|remove|list|search  Manage MCP servers
agentbrew mcp update <name>           Pull latest for a git-installed MCP server
agentbrew team set|sync|show          Manage team/org-level config sharing
agentbrew import [--from <agent>]     Import MCP servers from an agent or bundle
agentbrew export [-o file]            Export config as portable YAML/JSON bundle

Ops

agentbrew clean [name]                Remove a skill or command from all agents
agentbrew upgrade                     Check for and install CLI updates

Advanced Commands

These are available but hidden from default --help. Use agentbrew --help-all to see them.

• Sources: sources, fetch, remove-source
• Skills: skill, validate, pin, unpin, pinned, resolve, package
• Sync modules: rules, commands, agents, instructions, skills (each with init, sync, list)
• Ops: fix, diff, log, backup, rollback, lint, lock
• Infra: auto-sync, hook, completions

How Sync Works

• MCP Servers — one registry → deployed to each agent in its native format (JSON, TOML, YAML). Supports Claude Code, Cursor, Windsurf, Kiro, OpenCode, Amp, Codex, Goose, Cline, Roo Code.
• Rules — one markdown file → injected between managed markers (<!-- agentbrew:start/end -->) into each agent's rules file. Content outside markers is never touched.
• Commands — one canonical format (Markdown + YAML frontmatter) → auto-transformed per agent (strip frontmatter, adjust comment syntax).
• Drift Repair — agentbrew init installs a background scheduler that runs agentbrew check every 30 minutes. Detects drift and re-syncs automatically. Eight checks cover the full config surface: MCP servers, MCP env vars, rules markers, skills, broken symlinks, commands, instructions, and skill validity. Platform support: macOS (LaunchAgent + notifications), Linux (systemd user timer or cron fallback), Windows (not yet supported — run agentbrew check manually or via Task Scheduler).

Supported Agents (43)

Full config sync (skills + MCP + rules + commands):

| Agent | Skills | MCP | Rules | Commands | |-------|--------|-----|-------|----------| | Claude Code | ✓ | ✓ | ✓ | ✓ | | Cursor | ✓ | ✓ | — | ✓ | | Windsurf | ✓ | ✓ | ✓ | ✓ | | Augment | ✓ | — | ✓ | — | | Codex | ✓ | ✓ | ✓ | — | | OpenCode | ✓ | ✓ | — | ✓ | | Kiro | ✓ | ✓ | — | — | | Amp | ✓ | ✓ | — | — | | Goose | ✓ | ✓ | — | — | | Cline | ✓ | ✓ | — | — | | Roo Code | ✓ | ✓ | — | — |

Skills sync (31 additional agents):

Gemini CLI, Copilot, Trae, Trae CN, Junie, Continue, Warp, Antigravity, Qwen Code, OpenHands, Kilo Code, Droid, OpenClaw, Pi, Crush, Kode, Qoder, Zencoder, Cortex, Mistral Vibe, Mux, CodeBuddy, Kimi CLI, Replit, Universal, Command Code, iFlow CLI, MCPJam, Neovate, Pochi, Adal

Catalog

114 skills, 15 MCP servers, 5 rule sets — curated from Vercel, Anthropic, obra/superpowers, Supabase, Trail of Bits, actionbook, tasks.md, and more. ★ = installed with --recommended.

Skills

| Tier | Skills | |------|--------| | ★ Recommended (22) | find-skills, debug, plan, commit, review, taste, pr, pr-comments, verification-before-completion, skill-creator, next-task, agent-browser, project-audit, strategic-review, refactor, iterate, semgrep, codeql, supply-chain-risk-auditor, property-based-testing, insecure-defaults, playwright-best-practices | | Development (10) | react-best-practices, mcp-builder, composition-patterns, github-actions-debugging, next-best-practices, web-artifacts-builder, and more | | Design (7) | web-design-guidelines, frontend-design, fix-styles, shadcn, theme-factory, canvas-design, brand-guidelines | | Writing (6) | doc-check, rfc, rfc-iterate, markdown-for-gdoc, doc-coauthoring, internal-comms | | ML/AI (8) | hf-cli, huggingface-papers, huggingface-datasets, huggingface-gradio, huggingface-llm-trainer, and more | | Orchestration (16) | bosun, pipeline-ops, rescue-pipeline, orchestrator-researcher, orchestrator-developer, orchestrator-qa-engineer, orchestrator-reviewer, orchestrator-pipeline-runner, and more | | + 45 more | git, planning, security, dotfiles, browser, testing, utility, mobile, creative, deployment |

MCP Servers: context7 ★, playwright ★, tasks-mcp ★, github, filesystem, sentry, splunk, wavefront, jenkins, postgres, brave-search, notion, sequential-thinking, memory, openviking

Rules: conventional-commits ★, test-before-commit ★, minimal-changes ★, verify-before-completion ★, tasks-md-spec ★

Add any repo as a source to expand your catalog:

agentbrew add vercel-labs/agent-skills   # index available skills
agentbrew add ~/my-company/skills        # local folder
agentbrew catalog                         # browse built-in + all sources

Common Workflows

Add an MCP server everywhere:

agentbrew mcp add my-server -c npx -a my-mcp-pkg

Install an MCP server from a git repo:

agentbrew mcp add my-server --git https://github.com/org/my-mcp-server
agentbrew mcp add my-server --git https://github.com/org/my-mcp-server --ref v1.2.0
agentbrew mcp update my-server   # pull latest and re-sync

Team onboarding:

agentbrew team set https://github.com/my-org/agent-config && agentbrew sync

Add skills from a GitHub repo:

agentbrew add vercel-labs/agent-skills && agentbrew install react-best-practices

State

All state lives in ~/.config/agentbrew/state.yaml — detected agents, registered MCP servers, tracked sources, installed skills. Human-readable YAML.

Roadmap

See TASKS.md for the prioritized backlog.

Contributing

See CONTRIBUTING.md. Published to npm as agentbrew.

Development

npm install
npm run dev -- status          # run CLI in dev mode
npm test                       # vitest (63 test files, 1374 tests)
npm run typecheck              # tsc --noEmit
npm run build && npm run publish-latest  # build + publish to npm

Pure Node.js CLI. See AGENTS.md for repo layout and editing rules.

License

MIT