ccpulse 0.3.0

Track your custom Skills and Subagents usage in Claude Code

ccpulse

Track your custom Skills and Subagents usage in Claude Code

---

What it does

ccpulse analyzes your local Claude Code session data and shows:

• Skills - Your registered slash commands (like /commit, /review-pr)
• Custom Subagents - Your registered subagent types

Installation

pip install ccpulse

Usage

# Today (default)
ccpulse

# Last 7 days
ccpulse 7d

# Last 2 weeks
ccpulse 2w

# Last 1 month
ccpulse 1m

# From specific date (YYYYMMDD)
ccpulse 20260101

# Show only skills (top 5)
ccpulse 7d -s

# Show only subagents (top 5)
ccpulse 1m -a

# Show all skills (no limit)
ccpulse -s -f

# Combine options
ccpulse 2w -a -f

Options

Date Period (positional argument)

• (none) - Today only (default)
• 7d - Last 7 days
• 2w - Last 2 weeks
• 1m - Last 1 month
• 20260101 - From specific date to today (YYYYMMDD format)

Filtering

• --skills / -s - Show only custom skills
• --subagents / -a - Show only custom subagents
• --full / -f - Show all results (default: top 5). Requires --skills or --subagents

Other

• --version / -v - Show version and exit
• --help - Show help message

Example Output

╭────────────────────────────────── ccpulse ──────────────────────────────────╮
│  Period: Today                                                              │
│  Total Skill Calls: 95                                                      │
│  Total Subagent Calls: 69                                                   │
╰─────────────────────────────────────────────────────────────────────────────╯

CUSTOM SUBAGENT USAGE
────────────────────────────────────────────────────────────
code-generator  ██████████████████████████████  20
test-runner     ██████████████████████          15
debugger        ████████████████                11
linter          ████████████                     8
optimizer       █████████                        6

SKILL USAGE
────────────────────────────────────────────────────────────
commit          ██████████████████████████████  42
review-pr       ████████████                    18
lint-fix        ████████                        12
format-code     █████                            8
test            █████                            7

Data Source

Reads from ~/.claude/projects/ where Claude Code stores local session data. No data is sent anywhere - everything stays on your machine.

Requirements

• Python 3.10+
• Claude Code CLI installed

License

MIT

---

Made for the Claude Code community