mcpField
B
braintrust-analyze

braintrust-analyze

github.com/parcadeiAgent workflows3.9k486 installsUpdated 39w ago
Repository

About braintrust-analyze

braintrust-analyze examines Braintrust traces from Claude Code sessions for developers. It reports tool, agent, and skill usage, detects repeated-call loops, and summarizes activity and token trends.

Key features

  1. 01Break down tools and agents in a session
  2. 02List recent sessions and usage statistics
  3. 03Detect repeated tool-call loops
  4. 04Summarize daily and weekly activity

Use cases

  1. 01Review a session after a complex task
  2. 02Investigate why a task failed
  3. 03Track productivity and token trends

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill braintrust-analyze

After installing, type/braintrust-analyzein Claude Code to confirm it loaded.

Bundled filesSKILL.md.bakSKILL.v6.md

Details

From the project README

Braintrust Analysis

Analyze your Claude Code sessions for patterns, issues, and insights using Braintrust tracing data.

When to Use

  • After completing a complex task (retrospective)
  • When debugging why something failed
  • Weekly review of productivity patterns
  • Finding opportunities to create new skills
  • Understanding token usage trends

Commands

Run from the project directory:

# Analyze last session - summary with tool/agent/skill breakdown
uv run python -m runtime.harness scripts/braintrust_analyze.py --last-session

# List recent sessions
uv run python -m runtime.harness scripts/braintrust_analyze.py --sessions 5

# Agent usage statistics (last 7 days)
uv run python -m runtime.harness scripts/braintrust_analyze.py --agent-stats

# Skill usage statistics (last 7 days)
uv run python -m runtime.harness scripts/braintrust_analyze.py --skill-stats

# Detect loops - find repeated tool patterns (>5 same tool calls)
uv run python -m runtime.harness scripts/braintrust_analyze.py --detect-loops

# Replay specific session - show full sequence of actions
uv run python -m runtime.harness scripts/braintrust_analyze.py --replay <session-id>

# Weekly summary - daily activity breakdown
uv run python -m runtime.harness scripts/braintrust_analyze.py --weekly-summary

# Token trends - usage over time
uv run python -m runtime.harness scripts/braintrust_analyze.py --token-trends

Options

  • --project NAME - Braintrust project name (default: agentica)

What You'll Learn

Session Analysis
  • Tool usage breakdown
  • Agent spawns (plan-agent, debug-agent, etc.)
  • Skill activations (/commit, /research, etc.)
  • Token consumption estimates
Loop Detection

Find sessions where the same tool was called repeatedly, which may indicate:

  • Stuck in a search loop
  • Inefficient approach
  • Opportunity for better tooling
Usage Patterns
  • Which agents you use most
  • Which skills get activated
  • Daily/weekly activity trends

Examples

Quick Retrospective
# What happened in my last session?
uv run python -m runtime.harness scripts/braintrust_analyze.py --last-session

Output:

## Session Analysis
**ID:** `92940b91...`
**Started:** 2025-12-24T01:31:05Z
**Spans:** 14

### Tool Usage
- Read: 4
- Bash: 2
- Edit: 2
...
Find Loops
uv run python -m runtime.harness scripts/braintrust_analyze.py --detect-loops
Weekly Review
uv run python -m runtime.harness scripts/braintrust_analyze.py --weekly-summary

Requirements

  • BRAINTRUST_API_KEY in ~/.claude/.env or project .env
  • Braintrust tracing enabled (via braintrust-claude-plugin)

Comments

Markdown supported