Agent backends let you choose which harness runs a new session. The selector is a Preview feature and remains behind Developer Mode.
The selector names any missing component and shows the matching installation command. A running session keeps the backend it started with.
| Backend | What to know |
|---|---|
| Kiro CLI | Default backend with the fullest Crew integration and live MCP configuration updates |
| Claude Code | Runs through Claude's agent adapter and receives Crew MCP servers per session |
| KAS | Runs the Kiro agent harness through Kiro CLI's ACP relay |
| Codex | Uses the Codex ACP adapter, requires Crew's sandbox, and supports compaction |
| OpenCode | Uses the opencode binary, receives Crew MCP servers, and supports compaction |
| Pi | Requires both pi and pi-acp; does not receive Kiro Crew MCP tools |
| goose | Uses the goose binary and receives Crew MCP servers after its permission mode is verified |
| DeepSeek Harness | Runs dsh --profile acp; install dsh on the Gateway host and map provider keys from Settings → Secrets through agent.deepseek_env |
Crew checks the permission path a backend exposes before the first prompt. The capability card in Developer → Agent Backend is the current source for model, reasoning, compaction, steering, MCP, and session-resume support.
Two constraints are especially important:
pi-acp does not forward the MCP server array. Choose another backend when the session needs Crew memory, scheduling, subagent, or other MCP tools. kirocrew doctor reports this condition.Compaction is supported on both Codex and OpenCode sessions. Monitor controls, project changes, follow-up cards, and conversation reset work across all backends, subject to what the capability card reports for the selected harness.
agent.sandbox is off.Review Security before changing backends when your workflow depends on a specific approval or audit boundary.
Agent backends (Preview)