# Supported agents and compatibility

> Which coding agents Tokenade supports, how it attaches to each (hooks, plugin, MCP, LLM proxy) and which features each one gets.

Source: https://tokenade.net/en/docs/compatibility · Updated: 2026-10-14

Tokenade supports the coding agents below. `tokenade install` detects the ones on your machine and wires each through the strongest channel that agent offers. What an agent gets depends on that channel: a hook or plugin that sees every tool call covers more than an MCP-only integration.

## How Tokenade attaches to an agent

| Channel | What it is | Agents |
|---|---|---|
| Hooks | The agent calls Tokenade before and after its tools run | Claude Code, Codex, Cursor, Copilot CLI, Qwen Code, Grok, Droid, Antigravity CLI, T3 Code (through Claude Code) |
| Plugin or extension | A small Tokenade file the agent loads at start | OpenCode, Kilo Code, Cline, Hermes, Pi, OpenClaw |
| MCP wrapping | Third-party MCP servers run behind `tokenade mcp-wrap`, which folds their large results | Agents with an MCP config Tokenade can edit, plus Claude Desktop and the Codex app. Agents with a plugin (OpenCode, Kilo Code, Cline, Hermes) are left alone: the plugin already folds MCP results |
| LLM proxy | A local proxy on `127.0.0.1` between the agent and its provider | Set up automatically only where it adds a feature (for example Codex before its hooks are approved, Grok, Aider); opt-in everywhere else |
| Manual | You call `tokenade` commands yourself, or the agent does after reading the rules | Agents with no hook or plugin surface |

Each agent that loads a global rules file also receives a short Tokenade rules section in it, so it knows the `tokenade` commands (`map`, `skeleton`, `query`, `semantic`, `read`, `search`…).

## Feature matrix

**Legend:** Yes = covered automatically. Partial = covered, but not automatically or not for all traffic. Partial+ = partial with the binary alone, full once the [LLM proxy](https://tokenade.net/en/docs/llm-proxy) is set up for that agent. No = not covered.

| Agent | Channel | Command output | Web search | MCP results | Code search | Context | Re-read dedup | Documents & media | Secret redaction |
|---|---|---|---|---|---|---|---|---|---|
| Claude Code (CLI, desktop Code tab) | hooks | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Codex CLI | hooks | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Copilot CLI | hooks | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Cursor | hooks | Yes | Yes | Yes | Yes | Partial | Yes | Yes | Yes |
| OpenCode | plugin | Yes | Yes | Yes | Yes | Partial+ | Yes | Yes | Yes |
| Kilo Code | plugin | Yes | Yes | Yes | Yes | Partial+ | Yes | Yes | Yes |
| Cline | plugin | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Hermes | plugin | Yes | Yes | Yes | Yes | Partial+ | Yes | Yes | Yes |
| OpenClaw | plugin | Yes | Yes | Yes | Yes | Partial+ | Yes | Yes | Yes |
| Pi | extension | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Qwen Code | hooks | Yes / Partial+ (Windows) | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Grok | hooks + LLM proxy | Partial+ | Partial+ | Yes | Yes | Yes | Yes | Partial+ | Yes |
| Droid | hooks | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| T3 Code | Claude Code hooks | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Antigravity CLI | hooks | Yes | Yes | Yes | Yes | Partial | Yes | Yes | Yes |
| Aider | startup command + LLM proxy | Partial+ | Partial+ | Partial | Yes | Partial+ | Yes | Partial+ | Yes |
| Devin Desktop | manual | Partial | Partial | Yes | Yes | Partial | Yes | Partial | Yes |
| Copilot in VS Code | manual | Partial+ | Partial+ | Yes | Yes | Partial+ | Yes | Partial+ | Yes |
| Claude Desktop (Chat) | MCP only | No | No | Yes | No | No | Yes | No | Yes |
| Codex app | LLM proxy + MCP | See below | | | | | | | |
| Claude Cowork | not supported | No | No | Partial | No | No | Yes | No | Yes |

"Code search" means the `tokenade map`, `skeleton`, `query`, `impact` and `semantic` commands ([details](https://tokenade.net/en/docs/code-intelligence)). "Context" covers context-window optimisation such as the auto-compact threshold and folding history. "Documents & media" is `tokenade read` on PDF, Office, audio and video files ([details](https://tokenade.net/en/docs/read-documents-media)).

### Where these results come from

The matrix comes from Tokenade's compatibility probes. Each probe ran a real `tokenade install` in a throwaway home on Linux, macOS (Apple Silicon) and Windows 10, then exercised each feature through the channel that install produced. The last full probe run was on version 1.1.7; the Grok, Aider and Qwen Code (Windows) rows follow the 1.1.12 run. The changes since then that affect this table are listed below.

- **Grok:** its hooks can't rewrite a tool's output (PreToolUse only allows or denies, PostToolUse output is ignored), so command output, web pages and documents are folded by the local LLM proxy, which `tokenade install` offers for Grok.
- **Aider:** it has no hook, plugin or MCP client. The startup command loads `tokenade map`, and the LLM proxy folds the rest, on all three systems.
- **Qwen Code on Windows:** `cmd.exe` can't parse the hook's quoting, so command output is folded by the LLM proxy instead of the hook.

## Desktop apps (1.2.1)

- **Claude Desktop, Code tab:** runs Claude Code itself with your `~/.claude` settings, so it gets the full Claude Code row. Since 1.2.1, `tokenade install` sets it up even when no separate `claude` command is installed, by checking the copy of Claude Code bundled with the app.
- **Claude Desktop, Chat:** only MCP optimisation applies. Chat runs no local commands or file reads. `tokenade install` wraps the MCP servers in `claude_desktop_config.json`, including the Microsoft Store build on Windows.
- **Codex app:** runs Codex on your machine with your `~/.codex/config.toml`. Since 1.2.1 it gets the Codex coverage through the local LLM proxy (folded tool output, scrubbed credentials, the style note, savings figures), and MCP optimisation through `mcp-wrap`. The app's own built-in MCP server (browser and computer use) is left untouched.
- **Claude Cowork:** not supported. It runs in an isolated environment that local tools cannot reach.

MCP savings in desktop apps are credited to the app by name in your savings since 1.2.1, instead of "unknown".

## Hooks that need your approval

Some agents only run hooks after a validation step. Tokenade checks, per agent, whether its hooks really run, and lets the LLM proxy cover what they would have done only when they do not:

- **Codex:** each hook needs a trust entry in `~/.codex/config.toml`. `tokenade install` writes it; `tokenade codex-trust` re-applies it. See [Codex](https://tokenade.net/en/docs/codex).
- **Claude Code:** hooks are switched off by `disableAllHooks`, and do not run in a folder whose trust prompt you have not accepted. `tokenade healthcheck` reports the second case. See [Claude Code](https://tokenade.net/en/docs/claude-code).
- **Qwen Code:** needs `hooks.enabled: true` in `~/.qwen/settings.json`.
- **OpenClaw, Hermes:** the Tokenade plugin must be enabled in the agent's plugin list (install does it).

## Agents no longer supported

Gemini CLI and Reasonix are no longer supported since 1.1.19. `tokenade uninstall` still removes the hooks and settings older versions wrote for them. Windsurf is now handled as Devin Desktop (same paths). See [Antigravity](https://tokenade.net/en/docs/gemini-antigravity).

## Keeping the agent's own web search

To keep web queries inside your AI vendor, set `TOKENADE_NO_WEBSEARCH=1` in the agent's environment and run `tokenade install` once with it set. Tokenade then leaves the agent's web search alone, `tokenade search` refuses to run, and the rules it writes no longer mention it. Page fetching has its own switch, `TOKENADE_NO_WEBFETCH=1`. See [Environment variables](https://tokenade.net/en/docs/environment-variables).

## Related

- [Install Tokenade](https://tokenade.net/en/docs/install)
- [How hooks intercept tool calls](https://tokenade.net/en/docs/hooks)
- [Wrap MCP servers](https://tokenade.net/en/docs/mcp-wrap)
- [The LLM proxy](https://tokenade.net/en/docs/llm-proxy)
- [Other agents](https://tokenade.net/en/docs/other-agents)
