v2.2.0

Highlights

Finer control over which MCP tools agents see, a token-efficient search exposure mode (now the capa init default), and correct rule placement for providers that share AGENTS.md.

Tool exposure

• Per-server exposure. A server's expose: can be all (default), except, exactly or none. Adding tools: entries for a server switches it to a curated list.
• search mode. options.toolExposure: search lists only search and call_tool up front, so agents find tools on demand instead of loading every schema. New projects from capa init use it by default.
• Web UI. Server cards show how many tools are exposed and mark each as exposed or hidden. Adding the first tool for a server asks for confirmation, since that curates the server. Skill requires is hidden in search mode, where it has no effect. Token-savings estimates count only what agents actually receive.
• capa's MCP entry is now registered for projects whose tools come only from servers.

Rules for providers sharing AGENTS.md

• Rules restricted to certain providers no longer leak to other readers of AGENTS.md. Gemini CLI moves to GEMINI.md when it shares AGENTS.md, and .gemini/settings.json → context.fileName is set for you. capa records that ownership in capabilities.lock, so capa clean removes only what it added.
• appliesTo: ["dir/**"] rules become nested instruction files for providers that read them.
• Rules whose visibility or scope can't be represented are reported before anything is written. You can opt in per rule with visibility: best-effort / scope: best-effort.
• Deprecation: options.rules.conflicts defaults to warn in this release and will default to error in the next major.

Fixes

• Antigravity skills now install to .agents/skills (#241). Copies earlier releases wrote to .agent/skills aren't removed automatically, so delete them to avoid duplicates.
• Windows: capa clean path handling, and capa wrap argument quoting for .cmd shims.
• Concurrent installs: SQLite busy timeout, cross-process locks for plugin copies.
• Sub-agents honor provider targeting. Sub-agent refs to server-exposed tools no longer warn.
• MCP servers that need an API key show as pending credentials instead of failing install. Silent MCP connect failures and null capability fields are fixed.

Upgrade

capa upgrade

---

What's Changed

• Point public docs and install URLs at capa.sh by @Minitour in #205
• Keep marketplace fixture tests offline so main CI stays green by @Minitour in #206
• Update develop by @Minitour in #216
• fix: honor provider targeting for subagents by @toransahu in #215
• chore(deps): bump github/codeql-action from 4.37.7 to 4.37.9 by @dependabot[bot] in #214
• chore(deps): bump @napi-rs/keyring from 1.3.0 to 2.0.0 in the production-deps group by @dependabot[bot] in #218
• chore(deps): bump github/codeql-action from 4.37.7 to 4.37.9 by @dependabot[bot] in #217
• Treat missing MCP API-key servers as pending credentials during install by @Minitour in #219
• Fix null capability fields and silent MCP connect failures by @Minitour in #224
• Per-server MCP tool exposure (all / except / exactly) by @Minitour in #225
• Add the search tool exposure mode by @Minitour in #226
• Stop warning about sub-agent refs to server-exposed tools by @Minitour in #229
• chore(deps): bump @napi-rs/keyring from 1.3.0 to 2.0.0 in the production-deps group by @dependabot[bot] in #228
• chore(deps): bump github/codeql-action from 4.37.7 to 4.38.0 by @dependabot[bot] in #227
• Keep rules isolated for providers sharing AGENTS.md by @Minitour in #233
• Fix end-to-end test findings for v2.2.0 by @Minitour in #236
• Address Qodo review on the v2.2.0 release by @Minitour in #235
• Register capa's MCP entry for projects whose tools come from servers by @Minitour in #237
• Fix remaining issues from v2.2.0 end-to-end testing by @Minitour in #238
• Release: v2.2.0 by @Minitour in #234
• Default to search mode and show server tool exposure in the UI by @Minitour in #240
• Address Qodo review on tool exposure (release PR #242) by @Minitour in #243
• fix(antigravity): install skills to .agents/skills by @Minitour in #244
• Release: v2.2.0 (search default and tool exposure UI) by @Minitour in #242

New Contributors

• @toransahu made their first contribution in #215

Full Changelog: v2.1.2...v2.2.0