Host Compatibility
TokenPilot integrates with OpenClaw, Codex CLI, Claude Code, DeepSeek Harness, pi, and OpenCode. Each integration has a different boundary, so capabilities and setup instructions are documented per host.
Supported Hosts
| Host | Integration | Adapter Location |
|---|---|---|
| OpenClaw | Native plugin slot | components/adapters/openclaw/ |
| Codex CLI | Local proxy + hooks | components/adapters/codex/ |
| Claude Code | Local gateway + MCP | components/adapters/claude-code/ |
| DeepSeek Harness | Native Cordis plugin + optional context eviction + session status | components/adapters/deepseek-harness/ |
| pi | In-process extension + native recovery tool | components/adapters/pi/ |
| OpenCode | In-process v1 plugin + recovery MCP | components/adapters/opencode/ |
DeepSeek Harness provides opt-in context eviction and the read-only /tokenpilot-status command. It uses Harness's own transport and compaction, with separate profile configuration. See the DeepSeek Harness guide for installation, required settings, and troubleshooting.
The matrix below distinguishes shared product interfaces from host-native capabilities. — means the listed TokenPilot interface is not provided by that adapter; it does not describe unrelated features of the host itself.
TokenPilot Host Feature Matrix
| Feature | OpenClaw | Codex | Claude Code | DeepSeek Harness | pi | OpenCode |
|---|---|---|---|---|---|---|
| Stable Prefix | ✅ | ✅ | ✅ | — | ✅ (prompt sections) | ✅ (developer target only) |
| Context Reduction | ✅ | ✅ | ✅ | — | ✅ | ✅ |
| Automatic Context Eviction | ✅ | Opt-in response-chain rebase¹ | — | Opt-in; estimator and durable state required | Opt-in; native context_edit³ | Opt-in; durable request overlay³ |
| User-approved Context Cleaner | Scheduled canonical apply | Scheduled response-chain rebase | Scheduled request overlay | Native /tokenpilot-clean; scheduled surface transaction | — | — |
| Visual Inspector | ✅ | ✅ | ✅ | — | ✅ | ✅ |
Session Reports (report) | ✅ | ✅ | ✅ | —; native status instead | ✅ | ✅ |
| Session Status | /lightrsi status or CLI | lightrsi codex status | lightrsi claude-code status | /tokenpilot-status² | lightrsi pi status | lightrsi opencode status |
| Shared Standalone CLI | ✅ | ✅ | ✅ | —; Harness plugin interface | ✅ | ✅ |
| MCP Recovery Server | ✅ | ✅ | ✅ | — | —; native memory_fault_recover tool (pi has no MCP) | ✅ |
mode conservative | ✅ | ✅ | ✅ | —; profile configuration | ✅ | ✅ |
mode normal | ✅ | ✅ | ✅ | —; profile configuration | ✅ | ✅ |
mode aggressive | ✅ | — | — | —; profile configuration | — | — |
| Proxy / Gateway Startup | Gateway restart | SessionStart hook | SessionStart hook | Not needed; Harness owns transport | Not needed; in-process | Not needed; in-process |
¹ The Codex adapter README documents opt-in automatic eviction with both taskStateEstimator.enabled and contextRewrite.enabled. This does not provide the OpenClaw eviction commands or aggressive mode.
² DeepSeek Harness registers its status command when the profile provides command and session projection services. Its eviction pass runs before native Harness compaction by default. See DeepSeek Harness for configuration and status interpretation.
³ pi and OpenCode eviction uses the shared canonical-surface core (@lightrsi/eviction, lifted from the DeepSeek Harness adapter). It needs modules.eviction, eviction.enabled and taskStateEstimator.{baseUrl,model,apiKey}. Evicted content is archived and recoverable with memory_fault_recover.