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:

1. -p / --provider (highest priority)
2. A previous install recorded in the database
3. 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. Some still get instructions, rules, or sub-agent files where the client has a project-local convention (for example Antigravity rules in .agents/rules/, Windsurf rules in .windsurf/rules/).

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

Note

The registry evolves with capa releases. If an ID is rejected, run capa install -p invalid (or any unknown id): the error lists valid provider IDs.

Antigravity skills moved

Antigravity skills install to .agents/skills/ since capa 2.2.0 (earlier releases used .agent/skills/). Old copies under .agent/skills/ are not removed automatically: delete them to avoid duplicate skills.

Instruction files

capa writes agent snippets into each active provider’s instructions file, and folds rules into it for providers without a rules directory. Most providers read AGENTS.md; a few use their own file (and some, such as Windsurf or Amp, have none):

Provider	Instructions file
Claude Code	CLAUDE.md
GitHub Copilot	.github/copilot-instructions.md
CodeBuddy	CODEBUDDY.md
Pochi	README.pochi.md
Replit	replit.md
Gemini CLI	AGENTS.md, or a generated GEMINI.md when another active provider also reads AGENTS.md
Most others (Codex, Cursor, OpenCode, …)	AGENTS.md

Because several providers can share AGENTS.md, a rule restricted with providers may still be visible to other readers of that file. capa reports these cases before writing; see Rules → Shared instruction files. Codex and Gemini CLI also read nested instruction files, so directory-scoped rules (appliesTo: ["src/**"]) become src/AGENTS.md / src/GEMINI.md for them.

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

Tip

In CI, always pass -p <id> (or keep an explicit providers list) so installs never wait on a prompt.

Related

• Managed vs passthrough
• Agent instructions · Rules · Hooks · Sub-agents
• CLI: wrap · CLI: install