Commands

Command overview

Command	Description
`traces`	Open the TUI to browse traces
`traces login`	Authenticate with GitHub
`traces logout`	Clear local credentials
`traces whoami`	Show current login status
`traces namespace list`	List your namespaces
`traces namespace use <slug>`	Switch active namespace
`traces org new <name>`	Create an organization and switch to it
`traces <org-slug> invite code`	Create an invite code for an organization
`traces transfer <id> --to <slug>`	Move a trace to another namespace
`traces share`	Share a trace
`traces setup [skills]`	Install agent sharing setup for supported agents
`traces remove skills`	Remove installed agent sharing setup
`traces list`	List traces without the TUI
`traces status`	Show local DB and auth status
`traces doctor`	Diagnose installation issues (includes agent hook checks)
`traces reset`	Delete local DB and optionally credentials
`traces upgrade`	Update to the latest version
`traces uninstall`	Remove the traces binary
`traces version`	Show version

Authentication

traces login
traces login --no-browser  # prints URL for remote/SSH sessions

Opens your browser for GitHub OAuth device flow. The CLI stores a device token locally after authentication.

`traces logout`

traces logout

Revokes the server session and clears local credentials.

`traces whoami`

traces whoami

Shows your username, active namespace, and namespace type. Verifies credentials with the server.

Namespace management

`traces namespace list`

traces namespace list
traces ns ls  # alias

Lists all namespaces (personal and organizations) you belong to.

`traces namespace use <slug>`

traces namespace use my-org

Switches the active namespace. All subsequent CLI operations target this namespace.

`traces transfer <id> --to <slug>`

traces transfer abc123 --to my-org

Moves a trace to another namespace you have access to.

Organization management

`traces org new <name>`

traces org new "Acme"
traces org new "Acme" --json

Creates a new organization namespace, makes you its first admin, and switches your active namespace to that org automatically.

`traces org invite <slug> code`

Shortcut: traces <org-slug> invite code

traces org invite acme code
traces org invite acme code --email jane@example.com --max-uses 1
traces acme invite code --json

Creates an invite code for an organization you administer. The command prints the code, invite link, usage limit, and expiry timestamp.

Flag	Description
`--email EMAIL`	Attach an email hint to the invite
`--max-uses N`	Limit how many times the invite can be used (`0` = unlimited, `1` = single-use default)
`--json`	JSON output

You must be an org admin to create invite codes. Organization creation and invite creation require a logged-in user session and do not work with API keys.

Browsing

`traces` (no arguments)

Opens the interactive TUI for browsing and viewing traces.

`traces list`

traces list
traces list --limit 20
traces list --agent claude-code
traces list --json
traces list --diagnostics

Flag	Description
`--limit N`	Number of traces to return
`--agent ID`	Filter by agent
`--json`	JSON output
`--diagnostics`	Include diagnostic metadata

traces share --cwd .
traces share --trace-id abc123
traces share --source-path ~/.claude/projects/session.jsonl
traces share --cwd . --agent claude-code --visibility public --json
traces share --cwd . --key trk_your_api_key --json
traces share --cwd . --follow
traces share --list

See Sharing via CLI for full details.

Setup and maintenance

`traces setup [skills]`

traces setup
traces setup skills
traces setup skills --yes --agent claude-code --agent cursor
traces setup skills --global

traces setup currently maps to traces setup skills.

`traces remove skills`

traces remove skills
traces remove skills --yes
traces remove skills --global
traces remove skills --json

Removes files and hook wiring installed by setup for the current project scope (default) or global scope (--global).

See Sharing via Agent Skills for full setup details.

`traces doctor`

traces doctor

Checks authentication, database integrity, agent detection, agent hook installation, and API connectivity.

`traces status`

traces status

Shows local database location, authentication status, and active namespace.

`traces reset`

traces reset
traces reset --force     # skip confirmation
traces reset --all       # also clear credentials

Deletes the local database to force a full resync on next launch. With --all, also clears stored login credentials.

`traces upgrade`

traces upgrade
traces upgrade 0.5.0

`traces uninstall`

traces uninstall

Removes the traces binary from your system.

Commands

On this page