Metadata-Version: 2.4
Name: ccpulse
Version: 0.3.0
Summary: Track your custom Skills and Subagents usage in Claude Code
Project-URL: Homepage, https://github.com/dukbong/ccpulse
Project-URL: Repository, https://github.com/dukbong/ccpulse
Project-URL: Issues, https://github.com/dukbong/ccpulse/issues
Author: dukbong
License-Expression: MIT
License-File: LICENSE
Keywords: analytics,anthropic,claude,cli,statistics
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Description-Content-Type: text/markdown

# ccpulse

<p align="center">
  <img src="https://img.shields.io/pypi/v/ccpulse?color=E07A5F&style=flat-square" alt="PyPI version">
  <img src="https://img.shields.io/pypi/pyversions/ccpulse?color=81B29A&style=flat-square" alt="Python versions">
  <img src="https://img.shields.io/pypi/l/ccpulse?color=F2CC8F&style=flat-square" alt="License">
</p>

<p align="center">
  <b>Track your custom Skills and Subagents usage in Claude Code</b>
</p>

---

## 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

```bash
pip install ccpulse
```

## Usage

```bash
# 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

---

<p align="center">
  Made for the Claude Code community
</p>
