TracesDocs
DiscordHome
CLI

Supported Agents

Agent compatibility matrix for the Traces CLI adapters.

Traces uses adapter modules in the CLI to read each agent's native storage format and normalize sessions into a common trace structure.

Compatibility matrix

AgentIdentifierStorage format
Claude Codeclaude-codeJSONL
CursorcursorSQLite
OpenCodeopencodeJSON + SQLite
CodexcodexJSON
Gemini CLIgemini-cliJSON
PipiJSON
AmpampJSON
Copilot (VS Code)copilotSQLite
ClineclineJSON

How adapters work

When you run traces share, the CLI:

  1. Auto-detects which agent was used (or uses the --agent flag)
  2. Locates session data from known storage paths
  3. Normalizes data into typed trace messages
  4. Uploads the result through the API

Agent detection

The CLI detects agents by checking signature files and directories:

  • Claude Code -- .claude/
  • Cursor -- Cursor storage databases and project markers
  • OpenCode -- .opencode/ or XDG data directories
  • Codex -- .codex/ or codex.json
  • Gemini CLI -- .gemini/ directories
  • Pi -- .pi/ directories
  • Amp -- .amp/ and XDG data directories
  • Copilot -- .copilot/ and Copilot instructions markers
  • Cline -- .cline/ and Cline rules files

If multiple agents are detected, the CLI prompts you to choose. Skip detection when needed:

traces share --agent claude-code
  • traces setup installs share skills/hooks for detected agents
  • traces doctor validates detection and setup health
  • traces share --list --agent <id> helps you select the correct session

Commands

Complete reference for every Traces CLI command.

Troubleshooting

Diagnose and fix common issues with the Traces CLI.

On this page

Compatibility matrix
How adapters work
Agent detection
Related commands