CollectorView Markdown

Coding-Agent Collector

These examples use the hosted Trace Flow service. An account with access is required. For your own deployment, see self-hosted setup.

Coding-agent analytics is available in private alpha. Features and availability may change.

Trace Flow's private-alpha collector turns local coding-agent activity into cost, token, context, tool, repository, and review analytics in /app/agents.

To ask questions about those analytics in the app, use Trace Flow Analyst with an active Pro subscription. Analyst is not available on Hobby.

Download Trace Flow Desktop

The desktop app signs in through your browser and stores its Collector Credential in the OS keychain. A fresh install starts paused. Source detection is local and read-only; no facts are uploaded until you select Start syncing.

Supported sources

Source	Store	Support
Claude Code	`~/.claude/projects`	macOS and Windows collector
Codex CLI	`~/.codex/sessions`	macOS and Windows collector
Cursor	macOS global `state.vscdb`, read through a temporary snapshot	macOS

The collector parses transcripts locally and uploads redacted typed facts. The normal analytics path does not upload raw transcripts.

Use the CLI from source

The CLI does not currently have a published release asset. Developers can run it from a checkout:

bash

cargo run -p trace-flow-cli -- login
cargo run -p trace-flow-cli -- sources list
cargo run -p trace-flow-cli -- sync --since 7d

The installed binary exposes the same commands without cargo run -p trace-flow-cli --:

text

trace-flow login
trace-flow sources list
trace-flow sync [--since 24h|7d|30d|1y]
trace-flow status
trace-flow disconnect

sync defaults to a 24-hour incremental scan and resumes from the last complete sync watermark after downtime. Failed sessions keep their prior cursor and retry on the next cycle.

Privacy and credentials

Collector Credentials are separate from Trace Flow gateway API keys.
The normal CLI and desktop paths keep credentials in the OS keychain, not command arguments or config files. Headless development and CI may supply the documented environment override.
Transcript parsing, excerpt redaction, and source discovery happen locally.
Agent Ingest re-redacts free-text excerpts before enqueueing facts.
The desktop app remembers the user's sync or pause choice across relaunches.