Agent config today is scattered across CLAUDE.md, .cursor/rules/, , MCP JSON, hooks, and skill folders. No two teammates match. Nothing is pinned. Cloning the repo does not clone the agent setup.
One capabilities.yaml wires skills, tools, rules, sub-agents, MCP servers, and plugins into Cursor, Claude Code, Codex, Windsurf, GitHub Copilot, and 30+ other AI coding agents
ดาว
718
เครื่องมือ
—
อัปไทม์
—
AGENTS.md
CAPA collapses that into one version-controlled file next to your code — and a local MCP gateway in front of every tool:
capabilities.yaml — source of truth for every capability
capabilities.lock — SHA pins so tomorrow's clone gets the same bytes
Marker blocks — surgical writes that leave hand-edited content alone
MCP gateway — one endpoint per project; CAPA proxies stdio / HTTP / SSE servers, applies formatters, and records activity
The teammate who clones tomorrow gets the exact setup you have today.
Features
One file → 35+ agents — write once; CAPA fans out to each provider's native layout (.cursor/rules/, .claude/agents/, AGENTS.md, …)
MCP gateway — one local endpoint per agent; CAPA proxies upstream MCP servers, lazy-loads tools on demand, and filters tools per sub-agent
Cheaper inference, same quality — on-demand tool loading instead of front-loading the whole catalog (19–40% fewer tokens across 150 trials on claude-opus-4-8)
capa wrap — run Cursor, Claude, Codex, and more from a shadow workspace so provider dirs never touch your real repo
Local Web UI — interactive capabilities editor with live YAML sync, registry browse, OAuth setup, and drag-to-reorder
Activity traces — live feed of every MCP call, shell tool, and agent span on the project page
Plugins that unpack — Claude and Cursor plugins decompose into skills, MCP, rules, sub-agents, and hooks
Registries — browse skills.sh, Cursor Marketplace, Claude plugins, and Claude marketplace catalogs
capa add --passthrough — write provider-native files directly when you want unmanaged one-offs
Sub-agent isolation — each sub-agent gets a filtered MCP endpoint, so research agents never inherit a git push tool
capa install # interactive: confirms executable surface, then installs
capa install --yes # CI / scripts: skip confirmation
capa install --dry-run # preview MCP servers, hooks, and commands without changes
Resolves SHAs, fills the cache, writes per-provider files, and registers one MCP endpoint with each configured agent. Resolved SHAs land in capabilities.lock.
[!NOTE]
Non-interactive shells (CI, scripts) must pass --yes. The first install prints the executable surface (MCP stdio servers, hooks, command tools, plugins) and asks for confirmation; unchanged surfaces skip the prompt on re-run.
[!TIP]
Already have skills, MCP configs, and rules in the repo? After capa init, use the bundled /bootstrap skill — the agent scans the project and drafts the CAPA config for you.
4. Run tools from the terminal
capa sh # list every configured tool
capa sh brave # list brave subcommands
capa sh brave search --query "…" # run a tool directly
capa sh --raw brave search --query "…" # skip per-tool formatters
Every tool you define is also a CLI command under capa sh.
5. Open the Web UI
capa open # open this folder's project in the browser
capa open ../other # or any other project folder
capa status # prints the local URL when the server is up
Edit skills, tools, rules, hooks, plugins, and agents in the browser. Changes sync live back to capabilities.yaml.
capa wrap
Run an agent without polluting your repo with .cursor/, .claude/, and friends. CAPA builds a shadow workspace under ~/.capa/workspaces/, symlinks your project (minus provider-owned paths), installs capabilities into the shadow, and launches the agent.
capa wrap cursor # Cursor GUI — stops when the window closes
capa wrap claude # Claude Code (aliases: claude-code)
capa wrap agent # Cursor CLI
capa wrap codex
capa wrap gemini-cli
capa wrap opencode
capa wrap cursor --print-dir # print shadow path, then launch
capa wrap --prune # clean stale workspaces
capa stop # stop server + active wrap sessions
Wrappable today: Claude Code, Codex, Cursor, Gemini CLI, OpenCode, iFlow CLI, Kiro CLI, Qwen Code, Kimi CLI.
[!NOTE]
On Windows, creating the shadow workspace may require Developer Mode (or an elevated shell) for symlinks. GitHub Copilot is not wrappable yet — it owns shared .github/ / .vscode/ trees that need subpath exclusions.
Web UI & observability
The embedded React UI (served by the local server) covers the full project lifecycle:
Search seeded catalogs (skills.sh, Cursor Marketplace, Claude plugins) and add your own
Activity
Live tool-call feed, charts, and run timelines (default-on via options.agentActivity)
Variables / OAuth
Credential setup when install needs secrets
Activity is powered by system hooks and the MCP proxy tracer — MCP failures show as error rows, shell tools from capa sh are labeled correctly, and secrets in args/results are redacted.
Plugins & registries
Plugins are not opaque blobs. CAPA clones the repo, reads Claude (.claude-plugin/) or Cursor (.cursor-plugin/) manifests, and merges skills, MCP servers, rules, sub-agents, and hooks into the same install pipeline as everything else.
[!IMPORTANT]
Most registry adapters are executable TypeScript fetched into ~/.capa/registries-managed/. Review the source before enabling a third-party registry. Claude marketplaces are JSON catalogs only — safer by design.
Passthrough mode
Need a one-off native write without CAPA managing the file?
Passthrough skips capabilities.yaml, the lockfile, and managed-file tracking. Tool aliases, defaults, and formatters still require managed mode (capa add --tool … --passthrough is refused).
One capabilities.yaml wires skills, tools, rules, sub-agents, MCP servers, and plugins into Cursor, Claude Code, Codex, Windsurf, GitHub Copilot, and 30+ other AI coding agents
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
Capa ต้องใช้ API key ไหม?
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Capa ใช้ทรานสปอร์ตแบบใด?
Capa ทำงานแบบโลคัลผ่าน stdio
Capa ถูกตรวจสอบล่าสุดเมื่อใด?
ตรวจสอบล่าสุดเมื่อ 2026-11-05 One capabilities.yaml wires skills, tools, rules, sub-agents, MCP servers, and plugins into Cursor, Claude Code, Codex, Windsurf, GitHub Copilot, and 30+ other AI coding agents