ccost 0.3.0 → 0.4.0

package/README.md

@@ -1,4 +1,4 @@
-# ccost <img src="https://raw.githubusercontent.com/toolsu/ccost/main/logo.svg" alt="ccost" width="35" />
+# ccost <img src="https://raw.githubusercontent.com/cc-friend/ccost/main/logo.svg" alt="ccost" width="35" />
 
 Analyze Claude Code token usage and costs from local conversation logs and statusline data.
 
@@ -6,11 +6,11 @@ Reads JSONL files from `~/.claude/projects/`, deduplicates streaming entries, ca
 
 The [`ccost sl` subcommand](#statusline-analysis) ([setup statusline.jsonl first](#setup-for-statuslinejsonl)) analyzes `~/.claude/statusline.jsonl` for rate limit tracking, session summaries, budget estimation, and cost comparison (see [`ccost` vs `ccost sl`](#ccost-vs-ccost-sl)).
 
-Blazing fast CLI and library written in Rust with thorough tests. Also powers [CC Dashboard for Claude Code](https://github.com/toolsu/ccdashboard), a Tauri desktop app for visualizing your Claude Code usage and more.
+Blazing fast CLI and library written in Rust with thorough tests. Also powers [CC Friend (Claude Code Friend)](https://github.com/cc-friend/ccfriend), a Tauri desktop app for visualizing your Claude Code usage and more.
 
-[![crates.io](https://img.shields.io/crates/v/ccost)](https://crates.io/crates/ccost) [![npm](https://img.shields.io/npm/v/ccost)](https://www.npmjs.com/package/ccost) [![CI](https://github.com/toolsu/ccost/actions/workflows/ci.yml/badge.svg)](https://github.com/toolsu/ccost/actions/workflows/ci.yml) [![License](https://img.shields.io/badge/license-MIT-brightgreen)](https://github.com/toolsu/ccost/blob/main/LICENSE)
+[![crates.io](https://img.shields.io/crates/v/ccost)](https://crates.io/crates/ccost) [![npm](https://img.shields.io/npm/v/ccost)](https://www.npmjs.com/package/ccost) [![CI](https://github.com/cc-friend/ccost/actions/workflows/ci.yml/badge.svg)](https://github.com/cc-friend/ccost/actions/workflows/ci.yml) [![License](https://img.shields.io/badge/license-MIT-brightgreen)](https://github.com/cc-friend/ccost/blob/main/LICENSE)
 
-[中文文档](https://github.com/toolsu/ccost/blob/main/README.zh.md)
+[中文文档](https://github.com/cc-friend/ccost/blob/main/README.zh.md)
 
 ## Install
 
@@ -18,7 +18,7 @@ Blazing fast CLI and library written in Rust with thorough tests. Also powers [C
 npm i -g ccost
 ```
 
-Or download prebuilt binaries from [GitHub Releases](https://github.com/toolsu/ccost/releases).
+Or download prebuilt binaries from [GitHub Releases](https://github.com/cc-friend/ccost/releases).
 
 Or via Cargo (compiles from source):
 
@@ -46,7 +46,7 @@ ccost sl --chart 5h                      # rate limit chart
 
 | Flag | Description |
 |------|-------------|
-| `--per <dim>` | Group by: `day`, `hour`, `month`, `session`, `project`, `model`. Up to 2 for nested grouping. Default: `--per day --per model`. |
+| `--per <dim>` | Group by: `day`, `hour`, `month`, `session`, `project`, `model`, `subagent`, `tool`, `line`. Up to 2 for nested grouping. Default: `--per day --per model`. |
 | `--order <order>` | Sort: `asc` (default) or `desc`. |
 
 Two-level grouping creates parent-child rows, e.g. `--per day --per model` shows each day with per-model breakdowns.
@@ -268,6 +268,18 @@ ccost --per month --output csv --filename usage.csv
 # Two-level: project > model
 ccost --per project --per model --table full
 
+# Subagent cost breakdown
+ccost --per subagent --cost decimal
+
+# Session > subagent: see subagent cost within each session
+ccost --per session --per subagent
+
+# Tool cost breakdown: which tools consume the most tokens
+ccost --per tool --cost decimal
+
+# Per-line cost: cost of each JSONL line (user prompt / assistant response)
+ccost --per session --per line
+
 # Copy JSON to clipboard
 ccost --copy json
 
@@ -342,7 +354,7 @@ struct LoadOptions {
     session: Option<String>,
 }
 
-enum GroupDimension { Day, Hour, Month, Session, Project, Model }
+enum GroupDimension { Day, Hour, Month, Session, Project, Model, Subagent }
 
 struct GroupedData {
     label: String,
@@ -380,7 +392,11 @@ Reads JSONL conversation logs from Claude Code's local storage:
 - `~/.claude/projects/*/` (session files and `subagents/`)
 - `~/.config/claude/projects/*/` (alternate location)
 
-Both are scanned and deduplicated via symlink detection. Subagent transcripts are found in both the old (`<project>/subagents/`) and new (`<project>/<session-uuid>/subagents/`) directory structures.
+Both are scanned and deduplicated via symlink detection. Subagent transcripts are found in both the old (`<project>/subagents/`) and new (`<project>/<session-uuid>/subagents/`) directory structures. Each record carries an `agent_id` (the subagent file stem, or empty for the main session), enabling `--per subagent` grouping.
+
+### Tool & Line Extraction
+
+Each record's `message.content` is parsed with lightweight deserialization (only `type` and `name` fields from content blocks; `input`, `text`, etc. are skipped for performance). Tool names are extracted from `tool_use` blocks in assistant messages, enabling `--per tool` grouping. Each record also carries its JSONL line number (1-based), enabling `--per line` grouping. Line numbers are consistent with ccfriend's transcript line anchors (`#N`).
 
 ### Deduplication
 
@@ -406,7 +422,7 @@ Below we'll compare `ccost` (data from `~/.claude/projects/`) and `ccost sl` (da
 
 As shown by `ccost sl --per session --cost-diff`, when LiteLLM pricing is accurate, the cost computed from `~/.claude/projects/` closely matches the server-reported cost in `statusline.jsonl`. The statusline cost may occasionally undercount because it does not always include subagent costs. Since `~/.claude/projects/` has full per-request token breakdowns, it may be the more reliable source for cost.
 
-The primary value of `statusline.jsonl` is the rate-limit percentages, not cost. This is why [CC Dashboard for Claude Code](https://github.com/toolsu/ccdashboard) uses cost data computed from `~/.claude/projects/` combined with the 5-hour and 1-week rate-limit percentages from `statusline.jsonl`.
+The primary value of `statusline.jsonl` is the rate-limit percentages, not cost. This is why [CC Friend (Claude Code Friend)](https://github.com/cc-friend/ccfriend) uses cost data computed from `~/.claude/projects/` combined with the 5-hour and 1-week rate-limit percentages from `statusline.jsonl`.
 
 ### Project Path Decoding
 
@@ -416,15 +432,15 @@ Directory names like `-home-user-workspace-test` decode to `/home/user/workspace
 
 ### Terminal
 
-![Terminal output](https://raw.githubusercontent.com/toolsu/ccost/main/screenshot_terminal.png)
+![Terminal output](https://raw.githubusercontent.com/cc-friend/ccost/main/screenshot_terminal.png)
 
 ### Statusline Analysis (`ccost sl`)
 
-![Statusline output](https://raw.githubusercontent.com/toolsu/ccost/main/screenshot_terminal_sl.png)
+![Statusline output](https://raw.githubusercontent.com/cc-friend/ccost/main/screenshot_terminal_sl.png)
 
 ### HTML Report
 
-![HTML report](https://raw.githubusercontent.com/toolsu/ccost/main/screenshot_html.png)
+![HTML report](https://raw.githubusercontent.com/cc-friend/ccost/main/screenshot_html.png)
 
 ## Development
 

package/install.js

@@ -13,7 +13,7 @@ if (process.env.CCOST_SKIP_INSTALL) {
 }
 
 const VERSION = require("./package.json").version;
-const REPO = "toolsu/ccost";
+const REPO = "cc-friend/ccost";
 
 function getPlatformName() {
   const platform = process.platform;

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "ccost",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Analyze Claude Code token usage and costs from local conversation logs and statusline data (Rust CLI & lib)",
   "repository": {
     "type": "git",
-    "url": "https://github.com/toolsu/ccost"
+    "url": "https://github.com/cc-friend/ccost"
   },
   "author": "Tom Chen",
   "license": "MIT",