ChooChoo

Context engineering platform for AI coding agent harnesses

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 and prerequisites.

Quickstart

Initialize a project, validate, and connect an agent.

CLI Reference

Browse commands, flags, and machine-readable output.

Agent Trace

Record who changed what and why.

Learn more

Architecture

See how The Engine, The Map, and The Station fit together.

Why ChooChoo?

Understand the problems ChooChoo is designed to solve.

Supported Schemas

Explore ODPS, ODCS, OpenAPI, Arazzo, GraphQL, AsyncAPI, and AI System Card support.

Roadmap

Review shipped work and planned capabilities.