Tortilloid
Getting started / Connect your agents

Docs / Getting started / Connect your agents

Connect your agents

Bring Claude Code, Codex and any MCP agent into the same project memory.

Tortilloid runs a small MCP server on your Mac. Claude Code, Codex and any agent that speaks MCP connect to it, then work from the same Patch Log, Work Graph and Knowledge as Kongo.

Which agents are supported

AgentToday
KongoBuilt in.
Claude CodeSupported. Connect in one click.
CodexSupported. Connect in one click.
Other MCP agentsWork today when you add Tortilloid to the agent's own MCP settings by hand. See Other MCP agents.

One-click setup for more agents is coming. Need one now? Ask for it and we'll add it.

Claude Code and Codex: one click

  1. Open Settings (Tortilloid › Preferences…, Cmd+,) and choose Connected Agents.
  2. Find your agent. Each one shows its status, where it is installed and which settings file it uses.
  3. Click Connect.
  4. Start a new Claude Code or Codex session to pick up the change.

Connecting once covers every project you open in Tortilloid. You can also connect from the Your agents card on first launch.

What Connect changes

AgentSettings file
Claude Code~/.claude.json
Codex~/.codex/config.toml

Connect adds one entry named tortilloid and changes nothing else. A backup of the original file is kept beside it, and Disconnect removes only what was added. The entry points to a small bridge that ships with Tortilloid, and the access token is never copied into the agent's settings.

Instruction files

For projects where you want agents fully briefed, click Add guide to CLAUDE.md, or AGENTS.md for Codex. The guide sits between its own markers, so your own text is never touched.

If connecting fails

  • Tortilloid's agent server is not running. Reopen Tortilloid and try again.
  • The settings file is not valid JSON. It was left untouched. Fix the file, then connect again.
  • The agent rewrote its settings at the same moment. Try again.

Other MCP agents

Any agent that speaks MCP can work with Tortilloid. Add Tortilloid to that agent's MCP settings by hand, using the address http://127.0.0.1:58146/mcp. Every request needs the access token, sent as Authorization: Bearer <token>. The token is created on first use and kept in Tortilloid's data folder at mcp/tortilloid-mcp-token.txt, readable only by your account. Only connections from your own Mac are accepted.

Agents without MCP can still work with Tortilloid. Context › Copy Tortilloid CLI Prompt copies a prompt that teaches an agent to use the tortilloid command-line tool, which is read-only unless run with --write.

To change the access token, click Reset token in Connected Agents. Agents connected with one click keep working, because they read the token file on each request. Agents you set up by hand need the new token.

Permissions for connected agents

Kongo's permission prompts don't apply to connected agents. Use each agent's own approval settings, such as Claude Code's permission mode. See Known limits.

Changes an agent submits through Tortilloid land in the Patch Log. Changes an agent makes directly on disk are recorded too, as External Edits.

Hand-offs

Every agent records its work on a Work Graph thread. When another agent picks the work up, it resumes the same thread and reads the running report, decisions and next steps, instead of starting over.

Kongo sending work to Claude Code and Codex

Kongo can find your Claude Code and Codex chats and send work to them. Turn this on in Settings under Claude with Kongo or Codex with Kongo. Claude needs a one-time sign-in with the Claude command-line tool, and no API key. Codex support is experimental.