@ccusage/pi

> Analyze pi-agent session usage with the same reporting experience as ccusage.

Quick Start

``bash


Recommended - always include @latest

Since npx @ccusage/pi@latest is quite long to type repeatedly, we strongly recommend setting up a shell alias:

`bash


bash/zsh: alias ccusage-pi='bunx @ccusage/pi@latest'

> 💡 The CLI reads pi-agent session data from ~/.pi/agent/sessions/ (configurable via PI_AGENT_DIR).

Common Commands

`bash


Daily usage grouped by date (default command)

- PI_AGENT_DIR – override the pi-agent sessions directory (defaults to ~/.pi/agent/sessions)
- LOG_LEVEL – control log verbosity (0 silent … 5 trace)

What is pi-agent?

Pi-agent is an alternative Claude coding agent. It stores usage data in a similar JSONL format to Claude Code but in a different directory structure.

Features

- 📊 Daily/Monthly/Session Reports: Same reporting options as ccusage
- 💵 Accurate Cost Calculation: Uses LiteLLM pricing database
- 📄 JSON Output: Export data in structured JSON format with --json
- 📱 Compact Mode: Use --compact flag for narrow terminals

Data Source

Pi-agent session data is read from:

| Directory | Default Path |
| ----------------- | ----------------------- |
| Pi-agent sessions | ~/.pi/agent/sessions/` |

Documentation

For detailed guides and examples, visit ccusage.com.

Sponsors

$3

Check out ccusage: The Claude Code cost scorecard that went viral

License

MIT © @ryoppippi