# Braintrust Tracing

Braintrust tracing for Claude Code - hook architecture, sub-agent correlation, debugging

- Repository: https://github.com/parcadei/Continuous-Claude-v3 (3947 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-01-26
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add parcadei/Continuous-Claude-v3 --skill braintrust-tracing -g -a claude-code -y`
Codex: `npx skills add parcadei/Continuous-Claude-v3 --skill braintrust-tracing -g -a codex -y`
Cursor: `npx skills add parcadei/Continuous-Claude-v3 --skill braintrust-tracing -g -a cursor -y`
Gemini CLI: `npx skills add parcadei/Continuous-Claude-v3 --skill braintrust-tracing -g -a gemini-cli -y`

## Description

Braintrust tracing for Claude Code - hook architecture, sub-agent correlation, debugging

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Braintrust Tracing for Claude Code

Comprehensive guide to tracing Claude Code sessions in Braintrust, including sub-agent correlation.

## Architecture Overview

```
                         PARENT SESSION
                    +---------------------+
                    |  SessionStart       |
                    |  (creates root)     |
                    +----------+----------+
                               |
                    +----------v----------+
                    |  UserPromptSubmit   |
                    |  (creates Turn)     |
                    +----------+----------+
                               |
          +--------------------+--------------------+
          |                    |                    |
+---------v--------+  +--------v--------+  +--------v--------+
| PostToolUse      |  | PostToolUse     |  | PreToolUse      |
| (Read span)      |  | (Edit span)     |  | (Task - inject) |
+------------------+  +-----------------+  +--------+--------+
                                                    |
                                         +----------v----------+
                                         |   SUB-AGENT         |
                                         |   SessionStart      |
                                         |   (NEW root_span_id)|
                                         +----------+----------+
                                                    |
                                         +----------v----------+
                                         |   SubagentStop      |
                                         |   (has session_id)  |
                                         +---------------------+
```

## Hook Event Flow

The rest: https://github.com/parcadei/Continuous-Claude-v3/blob/HEAD/.claude/skills/braintrust-tracing/SKILL.md