braintrust-analyze

Analyze Braintrust tracing data from Claude Code sessions for patterns and insights.

3.9k|296|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/parcadei/Continuous-Claude --skill braintrust-analyze
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: braintrust-analyze
Source: https://github.com/parcadei/Continuous-Claude/tree/main/.claude/skills/braintrust-analyze
Command: npx skills add https://github.com/parcadei/Continuous-Claude --skill braintrust-analyze

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Braintrust analysis enables retrospective reviews of Claude Code sessions to identify patterns, issues, and insights from tracing data.

Core Features & Use Cases

  • Session breakdown: Summarize tools, LLMS turns, and spans.
  • Patterns & Metrics: Extract insights about efficiency and bottlenecks.
  • Use Case: Post-mortem a complex session to improve future runs.

Quick Start

uv run python -m runtime.harness scripts/braintrust_analyze.py --last-session

Frequently Asked Questions about braintrust-analyze

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze Claude Code sessions to identify patterns and bottlenecks?

Braintrust tracing analysis breaks down your Claude Code sessions into tool usage, LLM turns, and spans to surface efficiency patterns and bottlenecks. Run `uv run python -m runtime.harness scripts/braintrust_analyze.py --last-session` with BRAINTRUST_API_KEY configured to retrospectively review a session and extract actionable insights.

What data does Braintrust tracing capture from Claude Code?

Braintrust captures tool usage breakdowns, session replays, token trends, and span-level metrics from your Claude Code sessions. This tracing data enables post-mortem analysis to identify inefficiencies, detect loops, and inform skill creation or future session improvements.

What do I need to set up Braintrust tracing for Claude Code?

You need Braintrust API access, an active BRAINTRUST_API_KEY stored in ~/.claude/.env or your project environment, and plugin-enabled tracing in Claude Code. Once configured, the skill can ingest and analyze session traces without additional setup.

Can I use Braintrust analysis for debugging and productivity reviews?

Yes. Braintrust tracing is designed for post-mortem debugging, weekly productivity analysis, loop detection, and retrospective reviews of Claude Code sessions. Analyze patterns across multiple sessions to surface recurring issues and optimization opportunities.

What insights can I extract from analyzing session traces?

Session analysis reveals tool efficiency, LLM turn patterns, token consumption trends, and span-level performance. Use these insights for weekly productivity tracking, identifying repetitive loops, debugging complex workflows, and discovering opportunities to build specialized skills.