Getting Started

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/traces

Verify the installation:

traces version

2. Authenticate

traces login

This opens your browser for GitHub OAuth. Once authenticated, credentials are stored locally.

traces whoami

3. 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/abc123def

What happens during upload

1. Discovery -- scans agent storage paths for session files
2. Parsing -- reads the native format (JSONL, SQLite, JSON)
3. Normalization -- transforms into unified messages with typed parts
4. Upload -- batches messages to the Traces API
5. Processing -- generates highlights and summaries

4. Set up sharing integrations (optional)

Set up the integrations you want for sharing traces from your agent and Git workflow:

traces setup

Depending on what you choose, traces setup can install:

1. Agent skills — let agents share a session when you ask.
2. Agent hooks — share sessions automatically as an agent works.
3. Git hooks — attach traces to commits.

After setup, say "share this to traces" or "publish this session" to your agent and it will handle the rest.

If you want to remove anything you set up, run:

traces setup remove

What's next?