ChooChoo is a context engineering platform for AI coding agent harnesses. It gives your agents persistent memory, structured startup context, and a feedback loop to improve over time.

npm install -g @choochoo-works/cli
choochoo init
choochoo trace hooks install   # hooks into Claude Code, Gemini CLI, OpenCode, Codex

What you get

• Validate agent configs and schemas (ODCS, ODPS, OpenAPI, Arazzo, GraphQL, AsyncAPI, AI System Card) — locally and in CI/CD.
• Trace AI decisions. Auto-detect coding agents and install hooks that record every AI-assisted change in .choochoo/traces.jsonl.
• Compile startup context for agents. choochoo context generate scans your repo and produces a structured AGENTS.md your agent reads at session start.
• Benchmark agent quality. Traces feed evaluation harnesses (SWE-Bench, ITBench, custom task suites) so you can measure whether your agents are improving.

Get started

• Installation — Install the CLI in under a minute.
• Quickstart — Initialize a project, validate, and connect your coding agent.
• CLI Reference — Full command and flag reference.
• Agent Trace — Record who changed what and why.

Learn more

• Architecture — How The Engine, The Map, and The Station fit together.
• Why ChooChoo? — The three problems we're solving: context amnesia, ungoverned agents, and no feedback loop.
• Supported Schemas — ODPS, ODCS, OpenAPI, Arazzo, GraphQL, AsyncAPI, AI System Card.
• Roadmap — What's shipped, what's next.