ccusage 19.0.2 → 20.0.0

package/README.md

@@ -7,7 +7,6 @@
     <a href="https://socket.dev/api/npm/package/ccusage"><img src="https://socket.dev/api/badge/npm/package/ccusage" alt="Socket Badge" /></a>
     <a href="https://npmjs.com/package/ccusage"><img src="https://img.shields.io/npm/v/ccusage?color=yellow" alt="npm version" /></a>
     <a href="https://tanstack.com/stats/npm?packageGroups=%5B%7B%22packages%22:%5B%7B%22name%22:%22ccusage%22%7D%5D%7D%5D&range=30-days&transform=none&binType=daily&showDataMode=all&height=400"><img src="https://img.shields.io/npm/dt/ccusage" alt="NPM Downloads" /></a>
-    <a href="https://packagephobia.com/result?p=ccusage"><img src="https://packagephobia.com/badge?p=ccusage" alt="install size" /></a>
     <a href="https://deepwiki.com/ryoppippi/ccusage"><img src="https://img.shields.io/badge/DeepWiki-ryoppippi%2Fccusage-blue.svg?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==" alt="DeepWiki"></a>
     <!-- DeepWiki badge generated by https://deepwiki.ryoppippi.com/ -->
     <a href="https://github.com/hesreallyhim/awesome-claude-code"><img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code" /></a>
@@ -25,26 +24,51 @@
 
 ## Supported Sources
 
-The main CLI tool for analyzing Claude Code, Codex, OpenCode, Amp, and pi-agent usage from local data. Track daily, weekly, monthly, and session-based usage with beautiful tables.
+ccusage reads local usage data from coding agent CLIs and turns it into daily, weekly, monthly, and session reports.
+
+| Source             | Focused command example  |
+| ------------------ | ------------------------ |
+| Claude Code        | `ccusage claude daily`   |
+| Codex              | `ccusage codex daily`    |
+| OpenCode           | `ccusage opencode daily` |
+| Amp                | `ccusage amp daily`      |
+| Droid              | `ccusage droid daily`    |
+| Codebuff           | `ccusage codebuff daily` |
+| Hermes Agent       | `ccusage hermes daily`   |
+| pi-agent           | `ccusage pi daily`       |
+| Goose              | `ccusage goose daily`    |
+| OpenClaw           | `ccusage openclaw daily` |
+| Kilo               | `ccusage kilo daily`     |
+| Kimi               | `ccusage kimi daily`     |
+| Qwen               | `ccusage qwen daily`     |
+| GitHub Copilot CLI | `ccusage copilot daily`  |
+| Gemini CLI         | `ccusage gemini daily`   |
+
+Use `ccusage daily`, `ccusage weekly`, `ccusage monthly`, or `ccusage session` to include every detected source in one report.
 
 ## Installation
 
 ### Quick Start (Recommended)
 
-Thanks to ccusage's incredibly small bundle size ([![install size](https://packagephobia.com/badge?p=ccusage)](https://packagephobia.com/result?p=ccusage)), you can run it directly without installation:
+You can run ccusage directly without a global installation:
 
 ```bash
 # Recommended
 bunx ccusage
 
+# Nix
+nix run github:ryoppippi/ccusage -- daily
+
 # Alternative package runners
 pnpm dlx ccusage
 pnpx ccusage
 npx ccusage@latest
+
+# PR preview builds
+bunx -p https://pkg.pr.new/ryoppippi/ccusage@<pr-number> ccusage --offline
 ```
 
-> 💡 **Runtime**: `bunx ccusage` is recommended for everyday use. If you use `npx`, include `@latest` and use Node.js 22+.
-> Because the published CLI shebang targets Node.js, package runners can start ccusage under Node.js even when launched through `bunx`. When ccusage finds `bun` in `PATH`, it automatically re-runs the bundled entrypoint with Bun for better warm runtime performance. Set `CCUSAGE_BUN_AUTO_RUN=0` to force Node.js.
+> [bunx](https://bun.com/docs/pm/bunx) caches the downloaded package, so repeated runs are faster after the first launch.
 
 ## Usage
 
@@ -63,6 +87,16 @@ bunx ccusage claude daily --mode display
 bunx ccusage codex daily --speed fast
 bunx ccusage opencode weekly
 bunx ccusage amp session
+bunx ccusage droid daily
+bunx ccusage codebuff daily
+bunx ccusage hermes daily
+bunx ccusage goose daily
+bunx ccusage openclaw daily
+bunx ccusage kilo daily
+bunx ccusage kimi daily
+bunx ccusage qwen daily
+bunx ccusage copilot daily
+bunx ccusage gemini daily
 bunx ccusage pi daily --pi-path /path/to/sessions
 bunx ccusage pi daily --pi-path /path/to/sessions,/archive/pi/sessions
 
@@ -89,7 +123,7 @@ bunx ccusage monthly --compact  # Compact monthly report
 - 📊 **Daily Report**: View token usage and costs aggregated by date
 - 📅 **Monthly Report**: View token usage and costs aggregated by month
 - 💬 **Session Report**: View usage grouped by conversation sessions
-- 🤖 **Unified CLI Reports**: View Claude Code, Codex, OpenCode, Amp, and pi-agent usage from one CLI
+- 🤖 **Unified CLI Reports**: View Claude Code, Codex, OpenCode, Amp, Droid, Codebuff, Hermes Agent, pi-agent, Goose, OpenClaw, Kilo, Kimi, Qwen, GitHub Copilot CLI, and Gemini CLI usage from one CLI
 - ⏰ **5-Hour Blocks Report**: Track usage within Claude's billing windows with active block monitoring
 - 🚀 **Statusline Integration**: Compact usage display for Claude Code status bar hooks (Beta)
 - 🤖 **Model Tracking**: See which models are used across supported sources
@@ -107,31 +141,64 @@ bunx ccusage monthly --compact  # Compact monthly report
 - 🏗️ **Claude Instance Support**: Group Claude Code usage by project with `--instances` and filter by specific projects
 - 🌍 **Timezone Support**: Configure timezone for date grouping with `--timezone` option
 - ⚙️ **Configuration Files**: Set defaults with JSON configuration files, complete with IDE autocomplete and validation
-- 🚀 **Ultra-Small Bundle**: Unlike other CLI tools, we pay extreme attention to bundle size - incredibly small even without minification!
 
 ## Documentation
 
 Full documentation is available at **[ccusage.com](https://ccusage.com/)**
 
-## Development Setup
+## Development
 
-### Using Nix (Recommended for Contributors)
+<details>
+<summary>Nix-based contributor setup</summary>
 
-For contributors and developers working on ccusage, we provide a Nix flake-based development environment:
+Use the Nix flake development environment. Install [Nix](https://nixos.org/) with the `nix-command` and `flakes` experimental features enabled, then use [nix-direnv](https://github.com/nix-community/nix-direnv) so the repository dev shell loads automatically when you enter the directory:
 
-```bash
+```sh
 # Clone the repository
 git clone https://github.com/ryoppippi/ccusage.git
 cd ccusage
 
-# Allow direnv (automatically loads Nix environment)
+# Allow direnv to load the Nix dev shell
 direnv allow
+```
+
+The dev shell provides the pinned `pnpm`, Rust toolchain, GitHub CLI, and project utilities from `flake.nix`. It also installs package dependencies from `pnpm-lock.yaml` when needed.
 
-# Or manually enter the development shell
+If you do not use direnv, enter the shell manually:
+
+```sh
 nix develop
 ```
 
-This ensures consistent tooling versions across all contributors and CI systems. The development environment is defined in `flake.nix` and automatically activated via direnv when entering the project directory.
+Run the usual checks from inside the Nix environment:
+
+```sh
+pnpm run format
+pnpm typecheck
+pnpm run test
+```
+
+### Nix Package
+
+The flake exposes `ccusage` as the default package and app:
+
+```sh
+nix run github:ryoppippi/ccusage
+nix run github:ryoppippi/ccusage -- codex daily --offline
+nix build github:ryoppippi/ccusage
+```
+
+Nix builds embed the LiteLLM pricing file from the locked `litellm-pricing` flake input, so sandboxed builds do not fetch pricing at build time. To update the locked pricing snapshot and refresh the non-Nix Cargo fallback JSON:
+
+```bash
+nix flake update litellm-pricing
+nix run .#update-pricing-fallback
+nix flake check
+```
+
+The scheduled `update pricing` workflow runs the same commands and opens a PR when the locked input changes.
+
+</details>
 
 ## Sponsors