Home

Tracely wiki

Trace-native CI/CD for AI agents. Tracely grades every agent trace as it lands, clusters the failures into issues, freezes the bad runs into hermetic replayable cases, and blocks the pull request that would ship them again.

production trace  →  failure detection  →  regression test  →  CI gate

The trace is the source of truth. Evaluators, clusters, cases, gates and trends are all derived from it — there are no hand-authored datasets.

Where to go

I want to…	Page
Run it and send a first trace in 5 minutes	Getting Started
Understand the vocabulary (trace, turn, evaluator, cluster, case, gate)	Core Concepts
Block PRs with it	CI Gate
Host it myself	Self Hosting
See how it's built	Architecture
Contribute code	Development Guide
Fix "it doesn't work"	Troubleshooting
Know what's coming	Roadmap · Project Updates

Canonical sources

This wiki is the map. The detail lives in:

• doc.tracely-studio.xyz — the published SDK + product docs (quickstart, instrumentation, evaluations, scenarios, replay, CLI, MCP, self-hosting)
• README — the product pitch with screenshots
• guides/OVERVIEW.md — the complete guided tour, including war stories and honest limitations
• guides/DEMO.md — the 2-minute demo script
• design/ — the design dossier: the why behind every decision
• Per-folder READMEs: backend · frontend · sdk · workers · docs

Links

Website · PyPI tracely-ai · Issues · Security policy · Contributing · MIT licensed