Agent Traces and Work Map

Availability

Official release archives, install.sh, install.ps1, and Homebrew install ahtraces next to the main Autohand Code binary. The companion has its own private source repository, tests, build, and executable; the Autohand release process builds both products separately and bundles the matching binaries.

The companion is disabled by default. It does not monitor session files until you make an explicit consent choice. Local Work Map processing is available after consent. Cloud trace sync and Console visibility are included with paid Autohand Code plans, including Team.

No model quota charge: trace ingestion and storage does not count against Autohand API usage.

Install or upgrade both binaries

Use an official installer so the release-matched autohand and ahtraces executables are installed together.

macOS or Linux

curl -fsSL https://autohand.ai/install.sh | sh

Windows PowerShell

iwr -useb https://autohand.ai/install.ps1 | iex

Homebrew

brew install autohandai/code/autohand-code
# Existing installation:
brew upgrade autohandai/code/autohand-code

Confirm both commands resolve:

autohand --version
ahtraces --version

Choose a consent mode

New users choose during onboarding. Existing users are prompted once after upgrading to a consent-aware release. Cancelling leaves tracing off. Open /settings later to change between the four modes.

Mode	On this device	In Autohand Console
Disabled	The monitor is stopped and derived local trace data is removed.	Nothing is uploaded.
Local Work Map only	Known session stores are read and reduced to aggregate signals.	Nothing is uploaded.
Cloud sync — metadata only	Monitoring and Work Map stay on.	Pseudonymous timing, harness, model, provider, reasoning, token, relationship, and outcome metadata is synced.
Cloud sync — redacted full traces	Monitoring and Work Map stay on.	Metadata plus bounded, redacted prompts, responses, reasoning, and tool parts can be synced.

autohand --traces-on, autohand traces on, ah traces on, and ahtraces on select metadata only cloud sync. Redacted full traces require the separate explicit choice in /settings.

Start, inspect, and stop the monitor

autohand --traces-on
autohand --traces-off

autohand traces status
autohand traces on
autohand traces off
autohand traces stop

ah traces status
ah traces on
ah traces off
ah traces stop

ahtraces status
ahtraces on
ahtraces off
ahtraces stop

Control	Behavior
`status`	Reports whether the managed companion is running.
`on`	Stores consent for metadata sync and starts the companion.
`off`	Disables monitoring and sync, stops the companion, and removes derived local trace data.
`stop`	Stops the current daemon without changing consent. A later Autohand startup can start it again.

The autohand, autohand-code, and ah aliases expose the same traces subcommand.

19 supported coding agents

The read-only adapters inspect bounded, known locations for these harnesses. Agents that are not installed are skipped.

Autohand
Claude Code
Cursor
OpenCode
OpenCode 2
Codex
Pi
Amp
GitHub Copilot
Cline
OpenClaw
Hermes
Droid
Grok
Kimi Code
Antigravity
Prime Agent
fx
DeepSeek Harness

Supported native formats include JSON, JSONL, SQLite, and compressed JSONL. The normalized trace schema records available agent, model, usage, relationship, outcome, and verification fields.

Inspect the local Work Map

A Work Map scan reads local data and makes no network request.

autohand discovery map --since 30d
autohand discovery map --agent autohand,codex --json

The aggregate includes sessions, duration, token provenance, harness, model, provider, reasoning effort, tool categories, workflow motifs, outcomes, verification evidence, relationships, repository counts, and bounded recommendations.

It excludes prompts, responses, reasoning, commands, tool arguments and results, code and diffs, file paths, repository identities, session IDs, credentials, and environment values.

View traces in Autohand Console

Sign in from the CLI with autohand login or /login.
Enable metadata sync with autohand --traces-on.
Run sessions in Autohand or another supported coding agent.
Open console.autohand.ai/traces.
For a Team plan, select the intended Team account in the account switcher.

The Traces page shows account-scoped session traces and a cross-agent summary by harness, model, provider, and reasoning effort. Upload is incremental, so a new or updated session may take a short time to appear.

Delete cloud trace data

Turning monitoring off stops future sync and removes Autohand's derived local data. It does not remove data already uploaded.

Open Account in Autohand Console.
Find Agent trace data.
Select Delete agent trace data.
Type DELETE TRACES and confirm.

The action permanently removes trace metadata and any full trace content uploaded by your identity to the selected account. Other Team members' traces and the source session files owned by coding agents on your device remain. Future traces continue to sync while monitoring stays on.

Troubleshooting

ahtraces is missing: Upgrade with install.sh, install.ps1, Homebrew, or the matching release archive. Package-manager-only installations may not contain the separately built companion.
The monitor is not running: Run ahtraces status, then autohand traces on. Use autohand traces stop only for a temporary stop.
Local Work Map works but Console is empty: Confirm you chose metadata or full cloud sync, are signed in, and selected the expected personal or Team account in Console.
Old cloud data remains after turning traces off: Use the separate Delete agent trace data control on the Console Account page.