Sharing Traces

Sharing via Agent Hooks

Automatically share agent sessions as an agent works.

Set up agent hooks only for selected agents with:

traces setup agents --hooks

Agent hooks fire when:

  1. A session starts
  2. A prompt is submitted
  3. An agent completes

They track active traces in traces-active.json inside the git directory and upload traces in the background as the agent works.

Agent hooks are supported for Claude Code, Cursor, Codex, Copilot, Cline, OpenCode, Pi, Amp, OpenClaw, and Hermes.

To remove the agent integration (agent skills and agent hooks) from the current project, run:

traces remove agents

For commit-to-trace links, also set up Git hooks.

On this page

No Headings