Terminal UI
Browse traces, docs, and schemas in your terminal
The ChooChoo TUI is a keyboard-driven terminal interface for exploring your project. Launch it with:
choochoo tuiPass --dir to point at a custom content directory (default: ./choochoo/docs):
choochoo tui --dir ./my-docsTabs
The TUI has three tabs:
| Tab | What it shows |
|---|---|
| Agent Traces | Recent AI and human contribution traces from .choochoo/traces.ndjson |
| Documentation | Files and directories from your content directory |
| Schemas | Available validation schemas (ODPS, ODCS, AI System Card) |
Keyboard shortcuts
| Key | Action |
|---|---|
1, 2, 3 | Jump to tab 1, 2, or 3 |
← or [ | Previous tab |
→ or ] | Next tab |
↑, ↓ | Navigate lists |
Enter | Select item |
ESC or Ctrl+C | Exit |
Theme support
The TUI adapts to your terminal's color scheme automatically. It uses text attributes (bold, dim) rather than hardcoded colors, so it works with both light and dark themes.
Content directory
The TUI reads from:
- The
--dirCLI flag - The
CHOOCHOO_CONTENT_DIRenvironment variable ./choochoo/docs(default)
Run choochoo init to scaffold the default content directory if it doesn't exist.