Providers

Providers are the agent clients capa fans out to. You list them in the capabilities file or resolve them at install time with -p / --provider.

Declare providers

providers:
  - cursor
  - claude-code

providers is optional. When omitted, capa resolves the set from:

-p / --provider (highest priority)
A previous install recorded in the database
An interactive prompt (TTY); fails in CI/non-TTY unless you pass -p

capa install -p cursor
capa add owner/repo@skill-name -p claude-code

See CLI: install and CLI: add.

Integration levels

Level	What capa installs
MCP	Skills plus MCP client config (and often rules, hooks, agents, sub-agents where the provider supports them)
Skills	Skill files only (no project MCP registration for that provider)

Wrap is separate: only providers that declare a wrap launch config can be started with capa wrap. Installable ≠ wrappable.

Supported providers

IDs below are what you put in providers: or pass to -p / capa wrap.

Full MCP integration

Provider	ID	Wrap	Notes
Cursor	`cursor`	Yes (GUI); alias `agent` (CLI)	Plugin id alias: `cursor`
Claude Code	`claude-code`	Yes (`claude`)	Plugin id alias: `claude`
Codex	`codex`	Yes (`codex`)
Gemini CLI	`gemini-cli`	Yes (`gemini`)
OpenCode	`opencode`	Yes (`opencode`)
GitHub Copilot	`github-copilot`	No	Shared `.github` / `.vscode` paths — wrap disabled until subpath exclusions exist
CodeBuddy	`codebuddy`	No
Crush	`crush`	No
Droid	`droid`	No
iFlow CLI	`iflow-cli`	Yes (`iflow`)
Junie	`junie`	No
Kilo Code	`kilo`	No
Kiro CLI	`kiro-cli`	Yes (`kiro-cli`)
Kode	`kode`	No
Neovate	`neovate`	No
Pochi	`pochi`	No
Qwen Code	`qwen-code`	Yes (`qwen`)
Roo Code	`roo`	No
Trae	`trae`	No
Trae CN	`trae-cn`	No

Skills-only

These receive skill installs; they do not get a capa MCP server entry in the project.

Provider	ID	Wrap
AdaL	`adal`	No
Amp	`amp`	No
Antigravity	`antigravity`	No
Augment	`augment`	No
Cline	`cline`	No
Command Code	`command-code`	No
Continue	`continue`	No
Goose	`goose`	No
Kimi Code CLI	`kimi-cli`	Yes (`kimi`)
MCPJam	`mcpjam`	No
Mistral Vibe	`mistral-vibe`	No
Mux	`mux`	No
OpenClaw	`openclaw`	No
OpenHands	`openhands`	No
Pi	`pi`	No
Qoder	`qoder`	No
Replit	`replit`	No
Windsurf	`windsurf`	No
Zencoder	`zencoder`	No

Wrappable providers

Use these with capa wrap (interactive prompt when the provider is omitted):

Token	Launches	Kind
`cursor`	Cursor	GUI
`agent`	Cursor `agent` binary	CLI
`claude-code` / `claude`	Claude Code	CLI
`codex`	Codex	CLI
`gemini-cli`	Gemini CLI	CLI
`opencode`	OpenCode	CLI
`qwen-code`	Qwen Code	CLI
`kiro-cli`	Kiro CLI	CLI
`iflow-cli`	iFlow CLI	CLI
`kimi-cli`	Kimi Code CLI	CLI

capa wrap cursor
capa wrap claude
capa wrap agent --help   # passthrough args after the provider token

See Wrap workspaces and the wrap quick start.

GitHub / GitLab source prefixes

When adding remotes from the CLI, GitHub is the default host grammar (owner/repo@…). Prefix GitLab sources with gitlab::

capa add owner/repo@skill-name
capa add gitlab:group/sub/repo@skill-name
capa add --plugin gitlab:acme/platform/plugins/devops:v1.0.1

Private remotes need capa auth (or stored OAuth from the Web UI). See Credentials.

Install vs wrap

Path	Purpose
`capa install`	Write managed (or `--passthrough`) files into the real project for the resolved providers
`capa wrap`	Launch a wrappable provider against a shadow workspace under `~/.capa/workspaces`

capa install -p github-copilot   # ok — install target
capa wrap cursor                 # ok — wrappable
# capa wrap github-copilot       # rejected — not wrappable