session-stats

Session Stats Plugin for Claude Code

Track and display agent/skill invocation stats per session with a dashboard-style /session-stats command.

Features

• Tracks agent dispatches (SubagentStart/Stop)
• Tracks skill invocations (PreToolUse for Skill tool)
• Tracks task completions
• Per-session filtering (auto-detects current session)
• Dashboard display with Unicode bar charts
• Compact output for status line integration
• JSON output for programmatic use

Installation

From GitHub

Add the marketplace to your settings, then enable:

{
  "extraKnownMarketplaces": {
    "session-stats": {
      "source": {
        "source": "github",
        "repo": "YOUR_USERNAME/session-stats-plugin"
      }
    }
  },
  "enabledPlugins": {
    "session-stats@session-stats": true
  }
}

Local Development

claude --plugin-dir ~/Desktop/session-stats-plugin

Usage

Slash Command

/session-stats

Displays a dashboard like:

╭─ Session Stats ──────────────────────────────────────╮
│                                                      │
│  Session   05a8d9db                                  │
│  Duration  45m 30s                                   │
│  Activity  3 agents · 6 skills · 4 tasks             │
│                                                      │
│  AGENTS                                              │
│  laravel-expert      2  ━━━━━━━━━━━━━━━              │
│  claude-code-guide   1  ━━━━━━━                      │
│                                                      │
│  SKILLS                                              │
│  git-actions         3  ━━━━━━━━━━━━━━━              │
│  backend-testing     2  ━━━━━━━━━━                   │
│  lego-modules        1  ━━━━━                        │
│                                                      │
│  TIMELINE                                            │
│  05:44  ▹ skill   lego-modules                       │
│  05:46  ▸ agent   laravel-expert                     │
│  05:49  ✓ task    Implement user endpoint             │
│  05:50  ▹ skill   git-actions                        │
│                                                      │
╰──────────────────────────────────────────────────────╯

Status Line Integration

Add to your ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "python3 \"${CLAUDE_PLUGIN_ROOT}/scripts/session-stats.py\" --compact",
    "padding": 0
  }
}

Shows: agents:3 | top:laravel-expert | skills:6 | tasks:4

Events Tracked

Event	What's Captured
SessionStart	Session ID, model, source
PreToolUse (Skill)	Skill name, arguments
PreToolUse (Agent)	Agent type, description
SubagentStart	Agent ID, agent type
SubagentStop	Agent ID, transcript path
TaskCompleted	Task subject, teammate
Stop	Hook active status
SessionEnd	Reason

Data Storage

Logs are stored at ${CLAUDE_PLUGIN_DATA}/session-activity.jsonl (one JSON object per line).

License

MIT