+1
-3
@@ -1658,5 +1658,3 @@ #!/usr/bin/env node | ||
| "tkusage daily --source all", | ||
| "tkusage session --source all --compact", | ||
| "tkusage statusline", | ||
| "tkusage daily --json --source codex" | ||
| "tkusage daily --source all --since 2026-03-01 --until 2026-03-09" | ||
| ], | ||
@@ -1663,0 +1661,0 @@ githubUrl: dependencies.githubUrl |
+1
-1
| { | ||
| "name": "tkusage", | ||
| "version": "0.1.2", | ||
| "version": "0.1.3", | ||
| "description": "Unified local usage and cost estimation CLI for Claude Code and Codex", | ||
@@ -5,0 +5,0 @@ "type": "module", |
+27
-14
| # tkusage | ||
| Unified local usage and estimated cost reporting for Claude Code and Codex. | ||
| Unified local usage reporting for Claude Code and Codex. | ||
| `tkusage` is a standalone CLI. It reads local logs directly from `~/.claude/projects` and `~/.codex/sessions`, so normal report generation is fully offline. | ||
| `tkusage` reads local logs from `~/.claude/projects` and `~/.codex/sessions`, builds a cache, and prints source-aware reports. It does not depend on `ccusage` or `@ccusage/codex` at runtime. | ||
| The first run builds a local cache from your transcript/session files. Later runs reuse that cache and are much faster. | ||
| ## Install | ||
| ## Commands | ||
| ```bash | ||
| # one-off | ||
| npx tkusage daily --source all | ||
| # bun users | ||
| bunx tkusage daily --source all | ||
| # global install | ||
| npm install -g tkusage | ||
| ``` | ||
| ## Quick start | ||
| ```bash | ||
| # merged daily report | ||
| npx tkusage daily | ||
| npx tkusage daily --source all | ||
| # monthly report for one source | ||
| npx tkusage monthly 2026-03 --source codex | ||
| # date-filtered daily report | ||
| npx tkusage daily --source all --since 2026-03-01 --until 2026-03-09 | ||
| ``` | ||
| # session report | ||
| npx tkusage session --source all --compact | ||
| ## Date filters | ||
| # one-line bar/status output | ||
| npx tkusage statusline | ||
| Use `--since` and `--until` to limit the report range: | ||
| ```bash | ||
| npx tkusage daily --source all --since 2026-03-01 --until 2026-03-09 | ||
| ``` | ||
@@ -43,4 +56,4 @@ | ||
| - `Cost` is an estimated USD equivalent derived from embedded token pricing tables. | ||
| - It is not the same thing as your actual ChatGPT/Codex subscription billing or Anthropic invoice. | ||
| - Claude usage is deduplicated by `requestId` because transcript logs can repeat the same assistant usage entry more than once. | ||
| - `Cost` is an estimated USD equivalent derived from embedded token pricing tables | ||
| - It is not the same thing as your actual ChatGPT/Codex subscription billing or Anthropic invoice | ||
| - Claude usage is deduplicated by `requestId` because transcript logs can repeat the same assistant usage entry more than once |
58395
0.12%59
28.26%1664
-0.12%