agentbrew 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Filip Ivanishchev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,11 +1,31 @@
 # agentbrew
 
-One source of truth for AI coding agent config. Sync skills, MCP servers, rules, and commands across **42 agents** — Claude Code, Cursor, Windsurf, Augment, Codex, Gemini CLI, Copilot, OpenCode, Kiro, Amp, Trae, Junie, Continue, Warp, and more.
+[![npm version](https://img.shields.io/npm/v/agentbrew.svg)](https://www.npmjs.com/package/agentbrew)
+[![license](https://img.shields.io/npm/l/agentbrew.svg)](LICENSE)
+
+One config, every agent. Sync skills, MCP servers, rules, and commands across **42 AI coding agents** — Claude Code, Cursor, Windsurf, Augment, Codex, Gemini CLI, Copilot, OpenCode, Kiro, Amp, Trae, Junie, Continue, Warp, and more.
+
+```bash
+npx agentbrew init
+```
+
+## Installation
+
+**One-liner** (no install needed):
 
 ```bash
 npx agentbrew init
 ```
 
+**Global install** (faster repeated usage):
+
+```bash
+npm install -g agentbrew
+agentbrew init
+```
+
+Package: [npmjs.com/package/agentbrew](https://www.npmjs.com/package/agentbrew)
+
 ## The Problem
 
 Every AI coding agent wants its own config — `CLAUDE.md`, Cursor rules, Windsurf workflows, MCP server JSON, slash commands. When you use 2–4 agents (most developers do), keeping them in sync is manual, error-prone, and nobody's job. Config drifts silently.
@@ -13,13 +33,13 @@ Every AI coding agent wants its own config — `CLAUDE.md`, Cursor rules, Windsu
 ## What AgentBrew Does
 
 1. **Detects** your installed agents and discovers existing config
-2. **Syncs** MCP servers, rules, and commands to every agent in its native format
+2. **Syncs** MCP servers, rules, commands, and skills to every agent in its native format
 3. **Repairs** drift automatically — a LaunchAgent checks every 30 minutes, with macOS notifications
-4. **Catalogs** 51 curated skills, 11 MCP servers, 4 rule sets — install with one command
+4. **Catalogs** 67 curated skills, 11 MCP servers, 4 rule sets — install with one command
 5. **Sources** any GitHub repo or local folder as a skill source
-6. **Dashboards** — web GUI and full-screen TUI for visual management
-
-No other tool combines sync + drift repair + catalog + dashboard + sources in one CLI.
+6. **Dashboards** — web GUI (with catalog detail panels) and full-screen TUI
+7. **Portable** — export your entire config as a YAML/JSON bundle, import on another machine
+8. **Observable** — stats command shows sync history, drift breakdown, and health sparklines
 
 ## Quick Start
 
@@ -48,14 +68,19 @@ agentbrew check [--no-fix] [--ci]     Detect drift, broken symlinks, skill valid
 agentbrew doctor                      Alias for check
 agentbrew fix                         Force re-sync everything (all 6 modules)
 agentbrew diff                        Preview what sync would change (all 6 modules)
+agentbrew publish <skill> [--dry-run]  Validate, package, and publish a skill to registries
+agentbrew package <skill> [--dry-run]  Wrap a skill into an npm-publishable package (Agent Skills standard)
 agentbrew update                      Pull latest from all sources, re-sync
 agentbrew log [-n N]                  View sync and drift history
 agentbrew backup                      Snapshot current state
 agentbrew rollback                    Revert to last snapshot
+agentbrew stats                       Show sync history, drift, agents, MCP servers, and health
+agentbrew export [-o file] [--json]   Export config as portable YAML/JSON bundle
+agentbrew import --bundle <file>      Import from an export bundle (--replace to overwrite, --dry-run to preview)
 agentbrew discover                    Scan for unknown agents
 agentbrew lock                        Generate lock file with SHA pins
 agentbrew lock --verify               Verify lock file integrity
-agentbrew gui [-p PORT] [--no-open]   Web dashboard with live health, sync, and fix (localhost:3141)
+agentbrew gui [-p PORT] [--no-open]   Web dashboard with health, sync, fix, and catalog browser (localhost:3141)
 agentbrew dashboard                   Alias for gui
 agentbrew tui                         Full-screen terminal dashboard
 ```
@@ -97,7 +122,7 @@ agentbrew remove-source <url>         Stop tracking a source
 ### MCP Servers
 
 ```
-agentbrew mcp list                    Show registered servers
+agentbrew mcp list [--json]            Show registered servers
 agentbrew mcp add <name> -c <cmd> [-a args...] [-e KEY=VAL...]
 agentbrew mcp remove <name>           Remove from state + all agents
 agentbrew mcp sync                    Deploy to all agents
@@ -167,8 +192,8 @@ agentbrew auto-sync status            Show auto-repair status
 ### Skills
 
 ```
-agentbrew skill                       List all skills grouped by source
-agentbrew skill <name>                Show full info: metadata, capabilities, security, content
+agentbrew skill [--json]              List all skills grouped by source
+agentbrew skill <name> [--json]       Show full info: metadata, capabilities, security, content
 agentbrew capabilities <skill>        List capabilities for a skill
 agentbrew capabilities enable <skill> <cap>   Enable a capability
 agentbrew capabilities disable <skill> <cap>  Disable a capability
@@ -256,7 +281,7 @@ Gemini CLI, Copilot, Trae, Trae CN, Junie, Continue, Warp, Antigravity, Qwen Cod
 
 ## Catalog
 
-51 skills, 11 MCP servers, 4 rule sets — curated from [Vercel](https://github.com/vercel-labs/skills), [Anthropic](https://github.com/anthropics/skills), [obra/superpowers](https://github.com/obra/superpowers), [Supabase](https://github.com/supabase/agent-skills), [Trail of Bits](https://github.com/trailofbits/skills), [actionbook](https://github.com/actionbook/actionbook), [tasks.md](https://github.com/tasksmd/tasks.md), and more. ★ = installed with `--recommended`.
+67 skills, 11 MCP servers, 4 rule sets — curated from [Vercel](https://github.com/vercel-labs/skills), [Anthropic](https://github.com/anthropics/skills), [obra/superpowers](https://github.com/obra/superpowers), [Supabase](https://github.com/supabase/agent-skills), [Trail of Bits](https://github.com/trailofbits/skills), [actionbook](https://github.com/actionbook/actionbook), [tasks.md](https://github.com/tasksmd/tasks.md), and more. ★ = installed with `--recommended`.
 
 **Skills**
 
@@ -265,6 +290,7 @@ Gemini CLI, Copilot, Trae, Trae CN, Junie, Continue, Warp, Antigravity, Qwen Cod
 | ★ Recommended (15) | find-skills, debug, plan, commit, review, taste, react-best-practices, web-design-guidelines, frontend-design, mcp-builder, skill-creator, next-task, agent-browser, project-audit, refactor |
 | Strong (20) | pr, pr-fix, pr-comments, composition-patterns, fix-styles, screenshot, actionbook, doc-check, rfc, rfc-iterate, rfc-review, jira, jira-task, github-actions-debugging, cursor-bg, research-url, markdown-for-gdoc, webapp-testing, shadcn, next-best-practices |
 | Specialized (16) | postgres-best-practices, playwright-best-practices, react-native-guidelines, remotion-best-practices, sync-agent-config, subagent-driven-development, executing-plans, search, static-analysis, supply-chain-risk-auditor, property-based-testing, security-best-practices, better-auth-best-practices, dotfiles-development, dotfiles-new-module, dotfiles-doctor-debug |
+| Orchestration (16) | bosun, pipeline-ops, rescue-pipeline, inspect-and-heal-pipelines, orchestrator-researcher, orchestrator-alternatives-analyst, orchestrator-manager, orchestrator-developer, orchestrator-qa-engineer, orchestrator-reviewer, orchestrator-user, orchestrator-pipeline-runner, orchestrator-agent-improver, orchestrator-growth-hacker, orchestrator-indie-hacker, orchestrator-strategist |
 
 **MCP Servers**: context7 ★, playwright ★, tasks-mcp ★, github, filesystem, sentry, postgres, brave-search, notion, sequential-thinking, memory
 
@@ -286,12 +312,10 @@ All state lives in `~/.config/agentbrew/state.yaml` — detected agents, registe
 
 See [TASKS.md](TASKS.md) for the prioritized backlog.
 
-**Completed**: Web dashboard (GUI + TUI), tasks.md integration, auto-sync on all mutations, drift pre-fix reporting, macOS repair notifications, online catalog, team config, browsable web catalog, usage analytics, parallel sync, JSONC/TOML config support, GitHub Actions / CI integration, AgentAdapter pattern, pure diff/IO separation, MCP server sharing, skill patch system, per-project manifests, multi-registry search, structured error handling, security risk scoring, lock file with SHA pinning, per-project MCP configs, auth for remote MCP servers, format conversion for commands, automated agent discovery, feature flags / skill capabilities, skill preview / render
+**Completed**: Agent Skills packaging (`package` command for npm-publishable skill packages), skill marketplace (`publish` command with mdskills.ai + GitHub targets), config export/import (`export` / `import --bundle`), `stats` command with sparkline charts, GUI catalog detail panel with SKILL.md rendering + MCP server detail, web dashboard (GUI + TUI) with catalog browser + install/remove, tasks.md integration, auto-sync on all mutations, drift pre-fix reporting, macOS repair notifications, online catalog, team config, browsable web catalog, usage analytics, parallel sync, JSONC/TOML config support, GitHub Actions / CI integration, AgentAdapter pattern, pure diff/IO separation, MCP server sharing, skill patch system, per-project manifests, multi-registry search, structured error handling, security risk scoring, lock file with SHA pinning, per-project MCP configs, auth for remote MCP servers, format conversion for commands, automated agent discovery, feature flags / skill capabilities, skill preview / render, JSON output flag for CLI commands, self-upgrade command
 
 See [docs/COMPETITION.md](docs/COMPETITION.md) for competitive analysis vs MCPM, vsync, mdskills.ai.
 
-> **Note**: The npm package is `agentbrew` (with hyphen). The CLI command is `agentbrew` (no hyphen) for ergonomics. Both `agentbrew` and `agentbrew` work as commands.
-
 ## Contributing
 
 Want to add a skill, MCP server, or rule to the catalog? See [CONTRIBUTING.md](CONTRIBUTING.md).
@@ -301,7 +325,7 @@ Want to add a skill, MCP server, or rule to the catalog? See [CONTRIBUTING.md](C
 ```bash
 npm install
 npm run dev -- status          # run CLI in dev mode
-npm test                       # vitest (69 test files, 1260 tests)
+npm test                       # vitest (78 test files, 1516 tests)
 npm publish --access public    # publish to npm
 npm run generate:catalog-html  # build browsable catalog → docs/catalog/
 npm run typecheck              # tsc --noEmit

package/dist/agents.yaml

@@ -0,0 +1,173 @@
+# Agent definitions — loaded at runtime by agents.ts
+# Adding a new agent is a YAML edit, no code change or rebuild needed.
+#
+# Fields:
+#   name (required): agent identifier
+#   skillsDir (required): path to skills directory (~ expanded at runtime)
+#   mcpConfig: path to MCP server config file
+#   mcpKey: JSON key for servers object (default: "mcpServers")
+#   mcpFormat: config file format — json (default), yaml, toml
+#   mcpConfigVscodeExt: { extensionId, filename } — computed via vscodeExtConfigPath
+#   rulesFile: path to shared rules file
+#   commandsDir: path to commands directory
+#   agentsDir: path to agents directory
+#   commandTransform: transform key — "cursor" or "windsurf"
+
+- name: claude-code
+  skillsDir: ~/.claude/skills
+  mcpConfig: ~/.claude.json
+  rulesFile: ~/.claude/CLAUDE.md
+  commandsDir: ~/.claude/commands
+  agentsDir: ~/.claude/agents
+
+- name: cursor
+  skillsDir: ~/.cursor/skills
+  mcpConfig: ~/.cursor/mcp.json
+  commandsDir: ~/.cursor/commands
+  commandTransform: cursor
+
+- name: windsurf
+  skillsDir: ~/.codeium/windsurf/skills
+  mcpConfig: ~/.codeium/mcp_config.json
+  rulesFile: ~/.codeium/windsurf/memories/global_rules.md
+  commandsDir: ~/.codeium/windsurf/global_workflows
+  commandTransform: windsurf
+
+- name: augment
+  skillsDir: ~/.augment/skills
+  rulesFile: ~/.augment/guidelines.md
+
+- name: codex
+  skillsDir: ~/.codex/skills
+  mcpConfig: ~/.codex/config.toml
+  mcpFormat: toml
+  rulesFile: ~/.codex/AGENTS.md
+
+- name: gemini-cli
+  skillsDir: ~/.gemini/skills
+  commandsDir: ~/.gemini/commands
+  commandTransform: gemini
+  commandFileExt: .toml
+
+- name: copilot
+  skillsDir: ~/.copilot/skills
+
+- name: opencode
+  skillsDir: ~/.config/opencode/skills
+  mcpConfig: ~/.config/opencode/opencode.json
+  mcpKey: mcp
+  commandsDir: ~/.config/opencode/commands
+
+- name: kiro
+  skillsDir: ~/.kiro/skills
+  mcpConfig: ~/.kiro/settings/mcp.json
+
+- name: amp
+  skillsDir: ~/.config/amp/skills
+  mcpConfig: ~/.config/amp/settings.json
+  mcpKey: amp.mcpServers
+
+- name: goose
+  skillsDir: ~/.config/goose/skills
+  mcpConfig: ~/.config/goose/config.yaml
+  mcpKey: extensions
+  mcpFormat: yaml
+
+- name: cline
+  skillsDir: ~/.cline/skills
+  mcpConfigVscodeExt:
+    extensionId: saoudrizwan.claude-dev
+    filename: cline_mcp_settings.json
+
+- name: roo-code
+  skillsDir: ~/.roo/skills
+  mcpConfigVscodeExt:
+    extensionId: rooveterinaryinc.roo-cline
+    filename: cline_mcp_settings.json
+
+- name: trae
+  skillsDir: ~/.trae/skills
+
+- name: junie
+  skillsDir: ~/.junie/skills
+
+- name: continue
+  skillsDir: ~/.continue/skills
+
+- name: warp
+  skillsDir: ~/.agents/skills
+
+- name: antigravity
+  skillsDir: ~/.gemini/antigravity/skills
+
+- name: qwen-code
+  skillsDir: ~/.qwen/skills
+
+- name: openhands
+  skillsDir: ~/.openhands/skills
+
+- name: kilo
+  skillsDir: ~/.kilocode/skills
+
+- name: droid
+  skillsDir: ~/.factory/skills
+
+- name: openclaw
+  skillsDir: ~/.openclaw/skills
+
+- name: pi
+  skillsDir: ~/.pi/agent/skills
+
+- name: crush
+  skillsDir: ~/.config/crush/skills
+
+- name: kode
+  skillsDir: ~/.kode/skills
+
+- name: qoder
+  skillsDir: ~/.qoder/skills
+
+- name: zencoder
+  skillsDir: ~/.zencoder/skills
+
+- name: cortex
+  skillsDir: ~/.snowflake/cortex/skills
+
+- name: mistral-vibe
+  skillsDir: ~/.vibe/skills
+
+- name: mux
+  skillsDir: ~/.mux/skills
+
+- name: codebuddy
+  skillsDir: ~/.codebuddy/skills
+
+- name: kimi-cli
+  skillsDir: ~/.config/agents/skills
+
+- name: replit
+  skillsDir: ~/.config/agents/skills
+
+- name: universal
+  skillsDir: ~/.config/agents/skills
+
+- name: command-code
+  skillsDir: ~/.commandcode/skills
+
+- name: iflow-cli
+  skillsDir: ~/.iflow/skills
+
+- name: mcpjam
+  skillsDir: ~/.mcpjam/skills
+
+- name: trae-cn
+  skillsDir: ~/.trae-cn/skills
+
+- name: neovate
+  skillsDir: ~/.neovate/skills
+
+- name: pochi
+  skillsDir: ~/.pochi/skills
+
+- name: adal
+  skillsDir: ~/.adal/skills