branch-tracker

branch-tracker

A Claude Code plugin that tracks per-branch AI usage statistics — session counts, iterations, timing, and optional prompt capture.

Installation

Local development

git clone <repo-url> && cd branch-tracker
claude --plugin-dir /path/to/branch-tracker

Permanent install

git clone <repo-url> && cd branch-tracker
bash install.sh
claude --plugin-dir ~/.claude/plugins/branch-tracker

Configuration

Optionally create ~/.claude/plugins/branch-tracker/config.json:

{
  "webhook_url": "https://your-server.com/api/claude-stats",
  "webhook_token": "your-secret-token",
  "capture_prompts": false
}

Key	Description	Default
webhook_url	POST destination for session data	(none)
webhook_token	Bearer token for webhook auth	(none)
capture_prompts	Record user prompts to prompts.jsonl	false

Usage

Ask Claude about your branch stats:

• "Show me my branch stats"
• "How many sessions on feat/auth?"
• "What branches have I been working on?"

Or use the skill directly: /branch-stats

Data

All data is stored in ~/.claude/plugins/branch-tracker/data/.

sessions.jsonl

One line per Claude Code stop event:

{
  "timestamp": "2026-03-19T15:30:00+00:00",
  "session_id": "abc123",
  "repo": "my-app",
  "branch": "main",
  "cwd": "/Users/you/code/my-app"
}

prompts.jsonl

One line per user prompt (only when capture_prompts: true):

{
  "timestamp": "2026-03-19T15:30:00+00:00",
  "session_id": "abc123",
  "repo": "my-app",
  "branch": "main",
  "prompt": "Fix the login bug"
}

errors.log

Append-only log of any errors encountered by the hook script. The hook never blocks Claude Code — errors are logged silently.

Report

The report groups sessions by repository and branch:

Repository  Branch      Sessions  Iters  First Seen  Last Seen   Duration
──────────  ──────────  ────────  ─────  ──────────  ──────────  ────────
my-app      main               5     23  2026-03-15  2026-03-19  4d 0h
my-app      feat/auth          3     12  2026-03-17  2026-03-19  2d 0h

Run directly:

python3 ~/.claude/plugins/branch-tracker/scripts/report.py
python3 ~/.claude/plugins/branch-tracker/scripts/report.py --branch feat
python3 ~/.claude/plugins/branch-tracker/scripts/report.py --repo my-app

Requirements

• Python 3.7+ (stdlib only, no pip installs — requires datetime.fromisoformat)
• git 2.22+ (for git branch --show-current)
• macOS or Linux