cctrack 0.4.0__tar.gz → 0.5.0__tar.gz

cctrack-0.5.0/CLAUDE.md

@@ -0,0 +1,50 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+cctrack-py is a zero-dependency Python CLI that scans Claude Code JSONL log files and reports token usage and estimated cost. It's a Python port of the Go-based [cctrack dashboard](https://github.com/ksred/cctrack), stripped down to a single command that parses logs and prints a cost report.
+
+## Commands
+
+```bash
+# Install in development mode
+uv pip install -e .
+
+# Run the tool
+python -m cctrack
+# or after install:
+cctrack
+
+# Run all tests
+python -m pytest tests/
+
+# Run a single test
+python -m pytest tests/test_cctrack.py::test_name
+
+# Build distribution
+uv build
+```
+
+## Architecture
+
+This is a single-module CLI tool. All logic lives in `src/cctrack/__init__.py`:
+
+1. **Rate card** (`RATES`, `get_rates`, `calculate_cost`, `is_known_model`) - Model-to-price mapping using prefix matching. Order matters: longer/more-specific prefixes must come first (the legacy `claude-opus-4` 15/75 entry must stay below every `claude-opus-4-x`). Unknown models fall back to Sonnet rates and are flagged with `?` in the report.
+2. **File discovery** (`default_dirs`, `discover_files`) - Walks `~/.claude/projects/` and `~/.sandy/sandboxes/` for `.jsonl` files.
+3. **Remote aggregation** (`fetch_remote_jsonl`, `parse_remote_events`, `fetch_remote_hook_data`, `parse_remote_hook_data`) - SSHs to hosts, cats all JSONL logs plus statusline hook data (statusline files, monthly summaries, session baselines) with file separators, parses locally.
+4. **JSONL parsing** (`parse_lines`, `parse_events`, `dedup_events`) - Extracts `assistant` events with token usage. Deduplicates by `requestId` across all of a host's files (last event wins) — resumed sessions (`--resume`/`--continue`) repeat events with the same `requestId` in new files. Events without `requestId` are never deduped.
+5. **Aggregation** (`aggregate`) - Buckets events into daily and monthly summaries with token counts and costs.
+6. **Output** (`print_report`) - Prints current month-to-date summary with projections, daily breakdown, and previous month summaries. Cost is composed **per source** (one source per machine): hook cost where a source has statusline coverage, accuracy-factor-adjusted JSONL cost otherwise, summed per date. The accuracy factor is measured per source over dates strictly after that source's hook install day.
+
+Entry point: `cctrack:main` (registered in `pyproject.toml` as a console script).
+
+## Key Design Decisions
+
+- Zero external dependencies - stdlib only (json, argparse, subprocess, etc.)
+- Deduplication is global per host by `requestId` (last wins) - resumed sessions replay history into new files and must not double count. Cross-host `requestId` collisions can't occur (distinct API calls).
+- Hook data is authoritative for cost where present; JSONL-derived cost is an estimate. Never let one machine's hook coverage suppress another machine's JSONL cost - compose per source.
+- `session-baselines.json` carries each session's rolled-up cumulative across the 90-day retention boundary so straddling sessions aren't re-counted from zero.
+- Build system is Hatch (`hatchling`)
+- Requires Python 3.10+

{cctrack-0.4.0 → cctrack-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cctrack
-Version: 0.4.0
+Version: 0.5.0
 Summary: Claude Code cost tracker — scans JSONL logs and reports token usage + estimated cost
 Project-URL: Homepage, https://github.com/rappdw/cctrack
 Project-URL: Repository, https://github.com/rappdw/cctrack
@@ -86,27 +86,31 @@ Daily breakdown:
 
 ## Remote aggregation
 
-With `--remote`, cctrack SSHs to each host (one call per host) and streams back all JSONL content for local parsing. Requires SSH key auth.
+With `--remote`, cctrack SSHs to each host and streams back both the JSONL logs and the host's statusline hook data (`~/.claude/cctrack/`) for local parsing, so authoritative hook costs from every machine are summed per day. Requires SSH key auth.
 
 ```bash
 # Aggregate this machine + DGX server + laptop
 cctrack --remote dgx macbook-air
+
+# For accurate aggregate costs, install the hook on each host too
+cctrack --install-hook --remote dgx macbook-air
 ```
 
 ## Rate card
 
-Prices per million tokens, from [Anthropic's pricing page](https://www.anthropic.com/pricing):
+Prices per million tokens, from [Anthropic's pricing page](https://www.anthropic.com/pricing). Cache writes are priced per TTL: 5-minute at 1.25× input, 1-hour at 2× input.
 
-| Model | Input | Output | Cache Read | Cache Write |
-|---|---|---|---|---|
-| Opus 4.7 / 4.6 / 4.5 | $5.00 | $25.00 | $0.50 | $6.25 |
-| Opus 4 / 4.1 | $15.00 | $75.00 | $1.50 | $18.75 |
-| Sonnet 4.x / 3.7 | $3.00 | $15.00 | $0.30 | $3.75 |
-| Haiku 4.x | $1.00 | $5.00 | $0.10 | $1.25 |
-| Haiku 3.5 | $0.80 | $4.00 | $0.08 | $1.00 |
-| Haiku 3 | $0.25 | $1.25 | $0.03 | $0.30 |
+| Model | Input | Output | Cache Read | Cache Write 5m | Cache Write 1h |
+|---|---|---|---|---|---|
+| Fable 5 / Mythos 5 | $10.00 | $50.00 | $1.00 | $12.50 | $20.00 |
+| Opus 4.8 / 4.7 / 4.6 / 4.5 | $5.00 | $25.00 | $0.50 | $6.25 | $10.00 |
+| Opus 4 / 4.1 | $15.00 | $75.00 | $1.50 | $18.75 | $30.00 |
+| Sonnet 5 / 4.x / 3.7 | $3.00 | $15.00 | $0.30 | $3.75 | $6.00 |
+| Haiku 4.x | $1.00 | $5.00 | $0.10 | $1.25 | $2.00 |
+| Haiku 3.5 | $0.80 | $4.00 | $0.08 | $1.00 | $1.60 |
+| Haiku 3 | $0.25 | $1.25 | $0.03 | $0.30 | $0.50 |
 
-Unknown models fall back to Sonnet rates.
+Unknown models fall back to Sonnet rates and are flagged with `?` in the report's Model column.
 
 ## Origins
 

{cctrack-0.4.0 → cctrack-0.5.0}/README.md

@@ -61,27 +61,31 @@ Daily breakdown:
 
 ## Remote aggregation
 
-With `--remote`, cctrack SSHs to each host (one call per host) and streams back all JSONL content for local parsing. Requires SSH key auth.
+With `--remote`, cctrack SSHs to each host and streams back both the JSONL logs and the host's statusline hook data (`~/.claude/cctrack/`) for local parsing, so authoritative hook costs from every machine are summed per day. Requires SSH key auth.
 
 ```bash
 # Aggregate this machine + DGX server + laptop
 cctrack --remote dgx macbook-air
+
+# For accurate aggregate costs, install the hook on each host too
+cctrack --install-hook --remote dgx macbook-air
 ```
 
 ## Rate card
 
-Prices per million tokens, from [Anthropic's pricing page](https://www.anthropic.com/pricing):
+Prices per million tokens, from [Anthropic's pricing page](https://www.anthropic.com/pricing). Cache writes are priced per TTL: 5-minute at 1.25× input, 1-hour at 2× input.
 
-| Model | Input | Output | Cache Read | Cache Write |
-|---|---|---|---|---|
-| Opus 4.7 / 4.6 / 4.5 | $5.00 | $25.00 | $0.50 | $6.25 |
-| Opus 4 / 4.1 | $15.00 | $75.00 | $1.50 | $18.75 |
-| Sonnet 4.x / 3.7 | $3.00 | $15.00 | $0.30 | $3.75 |
-| Haiku 4.x | $1.00 | $5.00 | $0.10 | $1.25 |
-| Haiku 3.5 | $0.80 | $4.00 | $0.08 | $1.00 |
-| Haiku 3 | $0.25 | $1.25 | $0.03 | $0.30 |
+| Model | Input | Output | Cache Read | Cache Write 5m | Cache Write 1h |
+|---|---|---|---|---|---|
+| Fable 5 / Mythos 5 | $10.00 | $50.00 | $1.00 | $12.50 | $20.00 |
+| Opus 4.8 / 4.7 / 4.6 / 4.5 | $5.00 | $25.00 | $0.50 | $6.25 | $10.00 |
+| Opus 4 / 4.1 | $15.00 | $75.00 | $1.50 | $18.75 | $30.00 |
+| Sonnet 5 / 4.x / 3.7 | $3.00 | $15.00 | $0.30 | $3.75 | $6.00 |
+| Haiku 4.x | $1.00 | $5.00 | $0.10 | $1.25 | $2.00 |
+| Haiku 3.5 | $0.80 | $4.00 | $0.08 | $1.00 | $1.60 |
+| Haiku 3 | $0.25 | $1.25 | $0.03 | $0.30 | $0.50 |
 
-Unknown models fall back to Sonnet rates.
+Unknown models fall back to Sonnet rates and are flagged with `?` in the report's Model column.
 
 ## Origins
 

{cctrack-0.4.0 → cctrack-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cctrack"
-version = "0.4.0"
+version = "0.5.0"
 description = "Claude Code cost tracker — scans JSONL logs and reports token usage + estimated cost"
 readme = "README.md"
 license = "MIT"