Skip to main content

​
Get Termyte running

​
1. Install it

Termyte requires Node.js 20 or newer.

​
2. Connect your agents

Setup detects Claude Code, Codex, and OpenCode. Choose one or more for capture, then choose how memories should be formed:
  • verified Claude Code, Codex, or OpenCode authentication;
  • an OpenAI-compatible endpoint using TERMYTE_LLM_API_KEY;
  • capture only.
Agent mode runs the selected CLI non-interactively in the background. API mode calls the configured endpoint. Capture-only mode stores events without forming observations or memories.

​
3. Check the installation

Restart the selected agents, use one on a real repository, then run:
doctor reports the database path, installed hooks, queue state, pending traces, and recent context effects. The Viewer lets you inspect sessions, Work Thread episodes, stored history, context decisions, and runtime failures.

​
4. Create a Work Thread

A Work Thread keeps one task, its current state, and its evidence together. The CLI command is still termyte task.
The command prints JSON containing the task ID and version. Use those values when adding a step:
Task versions prevent an older agent or terminal from overwriting newer state. Use the version returned by the most recent task command.

​
Next steps

Work with tasks

Add steps and record explicit verification.

Checkpoint and resume

Save Git state and see what changed before continuing.

Choose an integration

Compare capture and context support.

Troubleshooting

Diagnose setup, queues, and missing capture.