termyte
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Warn
- fs module — File system access in package.json
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Termyte is a local execution and continuity layer for coding agents. It records agent execution, preserves evidence, maintains authoritative task state, and supplies relevant state and experience to later sessions.
Termyte
Termyte helps coding agents remember what happened in a repository.
It runs locally, records agent sessions, keeps useful decisions and task progress, and makes that history available to later sessions. A local Viewer lets you inspect the captured work.
Install
npm install -g termyte
termyte init
termyte viewer
termyte init connects Termyte to Claude Code, Codex, or OpenCode. You can use an agent's existing login, an OpenAI-compatible API, or capture events without creating memories.
Termyte stores its configuration and SQLite database in ~/.termyte.
Common commands
termyte init
termyte viewer [--no-open]
termyte doctor [--json]
termyte task <create|show|add-step|verify-step|checkpoint|resume|handoff> [options]
termyte uninstall
termyte help
Use termyte doctor to check the database, hooks, background work, and recent traces. Use termyte viewer to inspect sessions, tasks, memories, context, and failures.
For task continuity:
termyte task create --repo <repo-id> --title "Fix login" --objective "Restore login"
termyte task add-step --task <task-id> --title "Reproduce failure" --position 1 --version 1
termyte task checkpoint --task <task-id> --workspace <repo-path> --platform codex
termyte task resume --task <task-id> --workspace <repo-path>
Configuration
The main environment variables are:
| Variable | Purpose |
|---|---|
TERMYTE_DB |
SQLite database path |
TERMYTE_LLM_BASE_URL |
OpenAI-compatible API address |
TERMYTE_LLM_API_KEY |
API key |
TERMYTE_LLM_MODEL |
Model used to process observations |
TERMYTE_EMBED_MODEL_LOCAL |
Local model used for search |
TERMYTE_AUTO_WORKER |
Set to 0 to disable the background worker |
Development
npm install
npm run typecheck
npm test
npm run build
npm run verify
See docs/getting-started.md for setup details and docs/how-it-works.md for the processing flow.
Current limits
- Redaction helps remove secrets but is heuristic; review captured data before sharing it.
- OpenCode capture works, but automatic context injection is not supported.
- Search ranking has not been calibrated against a public coding-agent dataset.
- Retrieved history is context, not proof that it caused a later result.
- Strong claims about productivity still need controlled paired-agent trials.
License
MIT. See LICENSE.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found