Configuration
How ChooChoo stores configuration and data
ChooChoo uses a minimal configuration approach. Most behavior is controlled by CLI flags rather than config files.
Project data
.choochoo/ directory
The .choochoo/ directory in your project root stores local data:
| File | Purpose |
|---|---|
traces.ndjson | Agent trace records (newline-delimited JSON) |
This directory is created automatically when you run choochoo trace record or when trace hooks fire.
Content directory
The content directory (default: ./choochoo/docs) holds your documentation and spec files. It is created by choochoo init and used by choochoo tui, choochoo web, and choochoo validate.
User data
~/.choochoo/
Authentication credentials from choochoo auth login are stored in your home directory. Tokens expire after 90 days.
Environment variables
| Variable | Purpose | Default |
|---|---|---|
CHOOCHOO_CONTENT_DIR | Content directory for tui and web commands | ./choochoo/docs |
Planned: .choochoorc
[!NOTE] A project configuration file (
.choochoorc) is planned for controlling validation behavior, schema version pinning, and governance policies. See the Roadmap.