Traces Documentation
Share, discover, and collaborate on AI coding agent traces.
Traces captures conversations between developers and AI coding agents, normalizes them into a unified format, and makes them shareable. Share a session as a link, keep team work in a shared organization namespace, search past sessions from your agent over MCP, and export everything as a dataset when you need the raw data.
Supported agents: Claude Code, Cursor, OpenCode, Codex, Pi, Amp, GitHub Copilot, Cline, OpenClaw, Hermes, Droid, Grok, Kimi Code, Antigravity, Prime Agent, and fx. See the compatibility matrix for storage formats and detection details.
Quick start
Get started by installing the Traces CLI app via Homebrew, npm, or curl.
Once installed, run traces to start the Traces CLI app. You can also run traces --help to see all the commands available to you.
Connect your agent to past sessions
The hosted Traces MCP server gives your coding agent read-only access to the sessions you can see in Traces — no API key or local process required.
npx add-mcp https://mcp.traces.comWorking with organizations
Create a team namespace and generate an invite from the CLI:
traces org new "Acme"
traces acme invite code --email jane@example.com --max-uses 1See CLI Reference for full organization command docs and Creating a Team for the end-to-end team workflow.
Take your data with you
Export every trace in a namespace as a ZIP of JSONL files, then push a completed export straight to a HuggingFace dataset repo for fine-tuning or analysis.
Explore the docs
Getting Started
Install the CLI, authenticate, and share your first trace in under 2 minutes.
Sharing Traces
Share via CLI, agent skills, agent hooks, git hooks, or API keys.
Sharing via Agent Skills
Say "share this to traces" inside your agent session to share without leaving the conversation.
Traces MCP
Connect your coding agent over Streamable HTTP and OAuth to search and read previous Traces sessions.
Search Traces
Find local traces by keyword, error, file, tool, or date range from the CLI.
Traces CLI & App
Every command, flag, and option in the Traces CLI.
Data Export & HuggingFace
Export a namespace as JSONL and push completed exports to a HuggingFace dataset repo.
Using Traces in Teams
Team namespaces with shared traces and agents, member invites, email-domain auto-approval, roles, and namespace-scoped API keys.
Traces Web
Manage your account, profile, avatars, organizations, and billing in the web app.
API Reference
Authenticate with an API key and explore every supported endpoint with request and response examples.
Supported Agents
Full compatibility matrix with storage formats and detection details.