Getting Started
Get up and running with Traces in under 2 minutes.
Prerequisites
You need a GitHub account and at least one AI coding agent installed (Claude Code, Cursor, OpenCode, etc.).
1. Install the CLI
brew install market-dot-dev/tap/tracesVerify the installation:
traces version2. Authenticate
traces loginThis opens your browser for GitHub OAuth. Once authenticated, credentials are stored locally.
traces whoami3. Share your first trace
After a coding session with your AI agent, share it:
traces share --cwd .The CLI auto-detects which agent you used, finds the most recent session, uploads and normalizes it, and returns a shareable URL:
Trace shared successfully!
URL: https://www.traces.com/s/abc123defWhat happens during upload
- Discovery -- scans agent storage paths for session files
- Parsing -- reads the native format (JSONL, SQLite, JSON)
- Normalization -- transforms into unified messages with typed parts
- Upload -- batches messages to the Traces API
- Processing -- generates highlights, summaries, and search indexes
4. Set up agent sharing (optional)
Install the share skill so you can share traces from inside your agent:
traces setupAfter setup, say "share this to traces" or "publish this session" to your agent and it will handle the rest.
See Sharing from an Agent for setup modes, supported agents, and troubleshooting.