Trace coding-agent sessions in Braintrust.
This monorepo contains the plugins and the shared Rust tracing daemon embedded
in the Braintrust CLI (bt). Plugins forward native events locally; the daemon
builds traces, journals events for recovery, and delivers spans to Braintrust.
Install your coding agent and the Braintrust CLI, then authenticate and enable tracing. For example:
bt login
bt trace enable claude --project my-coding-agentReplace claude with your agent's CLI name below. Restart the agent after
setup and follow any plugin or hook trust prompts.
All six support bt trace enable, update, disable, and doctor.
| Agent and setup guide | CLI name | One-off traced run | Import / live attach | Distribution |
|---|---|---|---|---|
| Google Antigravity | antigravity |
— | Yes | GitHub |
| Claude Code | claude |
Yes | Yes | GitHub |
| Codex | codex |
Yes | Yes | GitHub |
| Grok | grok |
— | — | GitHub |
| OpenCode | opencode |
Yes | — | npm |
| Pi | pi |
Yes | — | npm |
Use run to trace one invocation, import to trace a saved session, or
import --attach to follow an active transcript:
bt trace run --project my-coding-agent claude -- -p "summarize this repository"
bt trace import claude SESSION_ID
bt trace import claude SESSION_ID --attachSee the agent guides for limitations. Antigravity setup requires a Unix-compatible shell.
bt trace doctor claude
bt trace status
bt trace update claude
bt trace disable claudedoctor shows which configuration is in use. status reports trace delivery.
update keeps your settings; disable removes the plugin and its settings.
src/plugins/<agent>/content/ Plugin source copied into distribution builds
src/runtime/js-daemon-client/ Shared JavaScript event-forwarding client
src/skills/ Shared skills included in plugin builds
bt-daemon/ Rust daemon, translators, and integration tests
scripts/ Shared build and publishing tools
.github/workflows/ CI and release automation
Use Bash and Python 3 for plugin scripts, Node.js 24 and pnpm 11.21.0 for the JavaScript packages, and stable Rust for the daemon. Run from the monorepo root:
make build # Build all plugins into dist/<agent>
make build-codex # Build one plugin
make test # Build and validate plugin packages and forwarders
cargo test --manifest-path bt-daemon/Cargo.toml --all-features --lockedReal-agent tests require installed agents and are run separately; see the test harness guide. See the daemon README for architecture and local debugging.
Edit plugin sources here. The per-agent GitHub distribution repositories and npm packages are generated artifacts. See AGENTS.md for the release PR and approval workflow, sandbox publishing, and npm release workflows.