Command reference

Launch and record

tracce claude [args...]
tracce codex [args...]
tracce exec -- <command> [args...]

The launched command owns the first terminal. Open the dashboard in a second terminal.

Attach to a running agent

tracce attach
tracce attach <pid>
tracce attach --agent codex
tracce attach --agent claude

Without a PID, tracce discovers running agents and opens a picker when more than one is available.

View and replay

tracce view
tracce view --latest
tracce view <session-id-prefix>
tracce list

tracce view always opens the session picker. --latest skips the picker and opens the newest session.

Export and import

tracce export <session-id-prefix>
tracce export --latest -o run.tracce.tgz
tracce import run.tracce.tgz

An export is a self-contained compressed session. After importing, replay it with tracce view <id>.

Repair permissions

If an interrupted trace leaves session files with unexpected ownership:

tracce fix-perms