opentraces
Open schema + CLI for agent trace capture, review, and upload to Hugging Face Hub.
Every coding session with an AI agent produces action trajectories, tool-use sequences, and reasoning chains. These are the most valuable dataset nobody is collecting in the open. opentraces captures them automatically, scans for secrets, and publishes structured JSONL datasets to HuggingFace Hub. Private by default. You control what leaves your machine.
What you get
As a developer. Share traces, get analytics back. Cost per session, cache hit rates, tool usage patterns, success rates. Your Spotify Wrapped for coding agents. Traces are searchable by dependency, so framework maintainers and researchers can find sessions relevant to their stack.
As an ML team. Real workflows, not synthetic benchmarks. Outcome signals for RL. Tool sequences for SFT. Sub-agent hierarchy for orchestration research. One dataset, many consumers, no vendor lock-in.
As a team lead. Commit traces automatically to a shared private dataset. Run downstream analytics, fine-tuning, or evaluation jobs on top of it. All on HuggingFace, all standard tooling.
Schema designed for downstream use
The schema is built for the people who consume traces, not just the tools that produce them. It is a superset of ATIF, informed by ADP and Agent Trace, and works across Claude Code, Cursor, Cline, Codex, and future agents without agent-specific fields.
- Training / SFT — Clean message sequences with role labels, tool-use as tool_call/tool_result pairs, outcome signals.
- RL / RLHF — Trajectory-level reward signals, step-level annotations, decision point identification via sub-agent hierarchy.
- Telemetry — Token counts, latency, model identifiers, cache hit rates, cost estimates per step.
- Code attribution (experimental) — File and line-level attribution linking each edit back to the agent step that produced it. Confidence varies by session complexity.
Docs
| Section | What's inside |
|---|---|
| Installation | Install, verify, upgrade |
| Authentication | Hugging Face login and credentials |
| Quick Start | Init, inbox, commit, push |
| Commands | Public and hidden CLI surface |
| Security Modes | Review policy, security pipeline |
| Schema | TraceRecord, steps, outcome, attribution |
| Workflow | Parse, review, assess, push, consume |
| CI/CD | Headless automation and token auth |
| Contributing | Local dev and schema changes |