Docs / Agents
Other agents
Updated
Beyond the agents with their own page, tokenade install detects and wires the agents below. Each section lists what is written and what to check. Paths use ~ for your home directory (%USERPROFILE% on Windows). Every agent also gets the feature coverage shown in the compatibility matrix.
Cline
| What | Where |
|---|---|
| Plugin | ~/.tokenade/cline-plugin/ (tokenade.ts, package.json), registered with cline plugin install |
| Rules | ~/.cline/rules/tokenade.md |
| MCP config (wrapped) | cline_mcp_settings.json in VS Code's global storage for saoudrizwan.claude-dev: ~/.config/Code/User/globalStorage/… (Linux), ~/Library/Application Support/Code/User/globalStorage/… (macOS), %APPDATA%\Code\User\globalStorage\… (Windows) |
The plugin only works once Cline has registered it, which needs the cline command on your PATH. If registration fails, install says so: ◐ cline — plugin files written, but cline did not register them: NOT active, tool results are not compacted for it.
Hermes
| What | Where |
|---|---|
| Plugin | ~/.hermes/plugins/tokenade/ (__init__.py, plugin.yaml), folds file reads and MCP results |
| Enable switch | tokenade added to plugins.enabled in ~/.hermes/config.yaml |
| MCP config (wrapped) | ~/.hermes/config.yaml |
| Usage | read from ~/.hermes/state.db |
HERMES_HOME overrides the folder; on Windows the default is %LOCALAPPDATA%\hermes. Hermes has no global rules file, so the rules go in the project files it reads. Uninstall deletes the plugin folder and removes tokenade from plugins.enabled (Hermes refuses to start with an enabled plugin that is missing).
Pi
| What | Where |
|---|---|
| Extension | ~/.pi/agent/extensions/tokenade.ts (Pi loads this folder on its own) |
| Rules | ~/.pi/agent/AGENTS.md |
Pi has no MCP configuration file, so there is nothing to wrap.
OpenClaw
| What | Where |
|---|---|
| Plugin | ~/.tokenade/openclaw-plugin/ (index.js, package.json, openclaw.plugin.json), registered with openclaw plugins install |
| Enable switch | plugins.entries.tokenade.enabled in ~/.openclaw/openclaw.json |
| Rules | ~/.claude/CLAUDE.md (the global file OpenClaw reads) |
OpenClaw's current configuration rejects an mcp key, so Tokenade writes no MCP entry for it. Uninstall runs openclaw plugins uninstall tokenade and deletes the plugin folder.
Qwen Code
| What | Where |
|---|---|
| Hooks | ~/.qwen/settings.json: a PreToolUse hook on shell commands and file reads: commands are rewritten to tokenade wrap, reads redirected to a folded copy |
| Enable switch | hooks.enabled: true in the same file (Qwen Code ignores every hook without it; install sets it) |
| Rules | ~/.qwen/QWEN.md |
| MCP config (wrapped) | ~/.qwen/settings.json |
If a model in Qwen Code has its own base URL (an OpenRouter setup, for instance), the LLM proxy sits on that address and forwards to the right provider.
Grok
| What | Where |
|---|---|
| Hooks | ~/.grok/hooks/tokenade.json: SessionStart and PreCompact (Grok accepts no substitution of a tool call or its output, so those are the two events Tokenade wires) |
| Rules | ~/.grok/rules/tokenade.md |
| MCP config (wrapped) | ~/.grok/config.toml |
Hooks listed by name in ~/.grok/disabled-hooks do not run. Older versions wrote Grok hooks into ~/.grok/user-settings.json, which Grok does not read; uninstall cleans both places.
Droid (Factory)
| What | Where |
|---|---|
| Hooks | ~/.factory/hooks.json: PreToolUse and PostToolUse on shell commands, plus SessionStart, UserPromptSubmit, PreCompact |
| Rules | ~/.factory/AGENTS.md |
| MCP config (wrapped) | ~/.factory/mcp.json |
hooks.hooksDisabled: true in ~/.factory/settings.json turns Droid's hooks off.
Aider
Aider has no hooks and no MCP. Tokenade adds a startup command: ~/.aider.conf.yml gets a load: line pointing at ~/.tokenade/aider-startup.txt, which runs /run tokenade map at the start of each session so the agent begins with a compact repo map. If your .aider.conf.yml already has a load: line, install leaves it alone. A backup of the file is taken first.
For a noisy command, run it through Tokenade yourself:
Aider's coverage differs between Linux/Windows and macOS: see the Aider row of the compatibility matrix. Where the LLM proxy adds a feature, install points Aider's API base in ~/.aider.conf.yml at it.
T3 Code
T3 Code is an orchestrator: it drives Claude Code (and other agents) and has no configuration of its own to wire. It runs Claude Code with your user, project and local settings, so it inherits the Claude Code hooks and full coverage. Agents it drives through their own wiring (Cursor, Grok, OpenCode) get theirs.
Devin Desktop (formerly Windsurf)
| What | Where |
|---|---|
| Rules | ~/.codeium/windsurf/memories/global_rules.md |
| MCP config (wrapped) | ~/.codeium/windsurf/mcp_config.json (same path on every OS) |
Devin Desktop has no hook surface: Tokenade commands are used by the agent from its terminal after reading the rules, and MCP results are folded by mcp-wrap. --only windsurf is a deprecated alias of --only devin-desktop.
Agents without a config file
Odysseus registers MCP servers through its web interface only, so there is no file Tokenade can write. You can still use the tokenade commands by hand.
Check and remove
tokenade detect # which agent is calling, and through which channel
tokenade llm-proxy status # agents that point at a local proxy
tokenade uninstall --dry-run
tokenade uninstall
tokenade uninstall removes the hook entries, deletes the plugin files and folders listed above, unregisters the Cline and OpenClaw plugins, edits Hermes' plugins.enabled, reverts LLM proxy settings, restores MCP servers and strips the rules sections. See Upgrade and uninstall.