burner-cc 0.1.0 → 0.1.2

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.2",
   "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');
 

package/src/render.js

@@ -12,10 +12,16 @@ export function renderReceipts(sessions) {
   mkdirSync(outDir, { recursive: true });
 
   const template = readFileSync(path.join(webDir, 'receipt.html'), 'utf-8');
-  const injected = template.replace(
-    '/*__BURNER_DATA__*/[]',
-    JSON.stringify(sessions)
-  );
+  // The logo has to be inlined as a data URI, not loaded as a separate
+  // file:// resource — html2canvas's Download button taints the canvas
+  // (SecurityError on toDataURL) if the receipt contains an <img> pulled
+  // in as its own file:// fetch, even from the same local directory.
+  const logoBase64 = readFileSync(path.join(webDir, 'logo-mark.png')).toString('base64');
+  const logoDataUri = `data:image/png;base64,${logoBase64}`;
+
+  const injected = template
+    .replace('/*__BURNER_DATA__*/[]', JSON.stringify(sessions))
+    .replace('/*__BURNER_LOGO_MARK__*/"logo-mark.png"', JSON.stringify(logoDataUri));
 
   const outHtml = path.join(outDir, 'receipt.html');
   writeFileSync(outHtml, injected, 'utf-8');

package/web/receipt.html

@@ -25,6 +25,7 @@
   <div id="root"></div>
 
   <script>window.__BURNER_DATA__ = /*__BURNER_DATA__*/[];</script>
+  <script>window.__BURNER_LOGO_MARK__ = /*__BURNER_LOGO_MARK__*/"logo-mark.png";</script>
   <script src="vendor/html2canvas.min.js"></script>
   <script src="receipt.js"></script>
 </body>

package/web/receipt.js

@@ -129,7 +129,7 @@ function receiptHtml(session, index) {
       </div>
       <div class="barcode" title="${bc.title}">${bc.html}</div>
       <div class="barcode-label">CC-SESSION-${session.sessionId.slice(0, 8).toUpperCase()}</div>
-      <img class="receipt-logo" src="logo-mark.png" alt="Burner" />
+      <img class="receipt-logo" src="${window.__BURNER_LOGO_MARK__ ?? 'logo-mark.png'}" alt="Burner" />
       <div class="footer brand">~ B U R N E R ~</div>
     </div>
   `;