burner-cc 0.1.0 → 0.1.1

package/README.md

@@ -7,14 +7,20 @@ Itemized dollar-and-token cost receipts for Claude Code sessions.
 ## Usage
 
 ```
-node bin/burner-cc.js                 # latest session -> opens a receipt
-node bin/burner-cc.js <session-id>    # specific session (accepts a prefix)
-node bin/burner-cc.js --all           # every session found, sliding through one receipt each
-node bin/burner-cc.js list            # quick terminal table, no browser
-node bin/burner-cc.js --json          # machine-readable, no browser
+npx burner-cc                 # latest session -> opens a receipt
+npx burner-cc <session-id>    # specific session (accepts a title, slug, or id prefix)
+npx burner-cc --all           # every session found, sliding through one receipt each
+npx burner-cc list            # quick terminal table, no browser
+npx burner-cc --json          # machine-readable, no browser
 ```
 
-Once published: `npx burner-cc`, `npx burner-cc --all`, etc.
+Or install it globally: `npm install -g burner-cc`, then run `burner-cc` directly.
+
+### Local development
+
+```
+node bin/burner-cc.js <same args as above>
+```
 
 ## How it works
 
@@ -24,8 +30,6 @@ Once published: `npx burner-cc`, `npx burner-cc --all`, etc.
 - **Receipt** (`src/build-receipt.js`) groups tokens by model and computes cost per token-type line.
 - **Rendering** (`src/render.js` + `web/`) injects the receipt JSON into `web/receipt.html` and opens it in the default browser. Theme buttons (paper / thermal / matrix / dark) switch CSS variables client-side.
 
-
-
 ## What this is not
 
 Not official billing. Composition breakdown by *source* (system prompt vs. skills vs. MCP tool schemas) isn't available from local transcripts alone — that needs request interception, which this tool doesn't do. The receipt instead itemizes by token *type*: fresh input, cache write, cache read, output.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "burner-cc",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Itemized dollar-and-token cost receipts for Claude Code sessions.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -1,8 +1,35 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { discoverSessions, findSession, latestSession } from './discover.js';
 import { buildReceipt, loadPricingTable } from './build-receipt.js';
 import { renderReceipts, openInBrowser } from './render.js';
 import { detectBillingMode } from './billing-mode.js';
 
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const HELP_TEXT = `burner-cc — itemized cost receipts for Claude Code sessions
+
+Usage:
+  burner-cc                    latest session -> opens a receipt
+  burner-cc <session>          specific session (title, slug, or id prefix)
+  burner-cc --all              every session found, sliding carousel
+  burner-cc list               quick terminal table, no browser
+  burner-cc --json             machine-readable output, no browser
+  burner-cc -h, --help         show this help
+  burner-cc -v, --version      show version
+
+Examples:
+  burner-cc
+  burner-cc my-renamed-session
+  burner-cc --all --json
+`;
+
+function printVersion() {
+  const pkg = JSON.parse(readFileSync(path.join(__dirname, '..', 'package.json'), 'utf-8'));
+  console.log(pkg.version);
+}
+
 function fmtUsd(n) {
   return '$' + n.toFixed(3);
 }
@@ -22,6 +49,16 @@ function printList(sessions, table) {
 
 async function main() {
   const args = process.argv.slice(2);
+
+  if (args.includes('-h') || args.includes('--help')) {
+    console.log(HELP_TEXT);
+    return;
+  }
+  if (args.includes('-v') || args.includes('--version')) {
+    printVersion();
+    return;
+  }
+
   const asJson = args.includes('--json');
   const filtered = args.filter((a) => a !== '--json');