Skip to main content

Adapter Capability Matrix

Living reference for framework capabilities vs. adapter implementations. As of 1.9.0 hatch3r supports 3 adapters: Claude Code, Cursor, and GitHub Copilot. Twelve adapters were removed in a hard cut — see the CHANGELOG for the full breaking-change list.

Legend

SymbolMeaning
YAdapter emits files for this capability
BBridge: content folded into an instruction file the platform reads
--Platform has no known support for this capability
skipPlatform supports this but only globally; intentionally omitted

Implementation Matrix

AdapterrulesagentsskillspromptscommandsmcpguardrailshooksmodelgithubAgentsagentTeams
cursorYYY--YY--YY----
copilotYYYYYY----YYY
claudeYYY--YY--YY----

Agent Model Customization

All 3 adapters emit model preferences when configured. See Model Selection for configuration and aliases.

AdapterEmissionNotes
cursorNativemodel: in agent YAML frontmatter
copilotNative (VS Code)model: in agent YAML; ignored on github.com
claudeGuidanceText in agent content

Secret Management

All MCP secrets are centralized in .env.mcp at the project root.

AdapterSecret loading methodAuto-loads .env.mcp?
copilotenvFile (STDIO) + ${input:NAME} (HTTP headers)STDIO: yes
cursor${env:VAR} from process envNo
claude${env:VAR} from process envNo

For editors that don't auto-load, source before launching:

set -a && source .env.mcp && set +a && <editor-command> .

Intentional Omissions

AdapterCapabilityReason
copilothooksNo documented hook/event system on GitHub Copilot Chat
allguardrailsCanonical location exists in bundled content for future use
allprompts (except copilot)Only Copilot has a dedicated prompts format
allgithubAgents (except copilot)Copilot-specific capability