claude-agent-ledger 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to `claude-agent-ledger` will be documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.1] — 2026-04-22
+
+### Added
+- `--anonymize` flag — replaces project paths with `~/repo-A`, `~/repo-B`,
+  ... and session ids with `sess-A`, `sess-B`, ... ordered by spend descending.
+  Use this when you want to share your output publicly (HN / Bluesky /
+  presentation) without leaking employer names or internal repo names.
+  Subagent / model / day labels stay untouched (those are public info).
+
 ## [0.4.0] — 2026-04-22
 
 ### Added

package/README.md

@@ -180,6 +180,7 @@ If Anthropic's actual rate differs (or web_fetch has its own price), open an iss
 |---|---|
 | `--summary` | One-screen dashboard with all the headline numbers |
 | `--by <subagent\|model\|day\|project\|session>` | Group rows. Default: `subagent`. `day` renders as ASCII bar chart. |
+| `--anonymize` | Replace project paths and session ids with `~/repo-A`, `sess-A`, ... so you can share screenshots without doxing your employer / private repos. |
 | `--md` | Markdown table output (good for committing or sharing) |
 | `--json` | Raw JSON output (pipe into jq) |
 | `--plan pro\|max` | Hide dollar columns; show token utilization only |

package/bin/agent-ledger.ts

@@ -14,6 +14,7 @@ interface Args {
 	plan: Plan;
 	by: GroupKey;
 	summary: boolean;
+	anonymize: boolean;
 }
 
 function periodRange(period: Period): { from: Date; to: Date } {
@@ -47,6 +48,9 @@ Flags:
   --md                        Markdown table output (good for sharing / commits)
   --json                      Raw JSON output (for piping into jq)
   --plan pro|max              Suppress dollar columns (token utilization only)
+  --anonymize                 Replace project paths and session ids with safe
+                              placeholders (~/repo-A, sess-A) so the output is
+                              shareable without doxing yourself.
 
 Environment:
   NO_COLOR=1                  Disable ANSI colors
@@ -101,9 +105,31 @@ function parseArgs(argv: string[]): Args {
 		plan,
 		by,
 		summary: rest.includes('--summary'),
+		anonymize: rest.includes('--anonymize'),
 	};
 }
 
+// Replace identifying labels with safe placeholders. Run after aggregation,
+// before formatting. We anonymize project paths (which leak employer + repo
+// names) and session ids; leave subagent / model / day untouched (those are
+// either public Anthropic info or generic agent type names).
+function anonymizeReport(report: LedgerReport, group: GroupKey): LedgerReport {
+	if (group !== 'project' && group !== 'session') return report;
+	const prefix = group === 'project' ? '~/repo-' : 'sess-';
+	const labelFor = (i: number): string => {
+		// Use A..Z then AA..ZZ for many entries
+		if (i < 26) return prefix + String.fromCharCode(65 + i);
+		return prefix + String.fromCharCode(65 + Math.floor(i / 26) - 1) + String.fromCharCode(65 + (i % 26));
+	};
+	const newRows = report.rows.map((r, i) => ({ ...r, subagent: labelFor(i) }));
+	return { ...report, rows: newRows };
+}
+
+// For --summary we may need to anonymize multiple sub-reports.
+function anonymizeForSummary(byProject: LedgerReport): LedgerReport {
+	return anonymizeReport(byProject, 'project');
+}
+
 function planMask(report: LedgerReport, plan: Plan): LedgerReport {
 	if (plan === 'payg') return report;
 	const zero = () => ({
@@ -139,17 +165,19 @@ async function main(): Promise<void> {
 	const turns = await collectTurns({ from, to });
 
 	if (args.summary) {
-		const [bySub, byMod, byDay, byProj] = await Promise.all([
+		const [bySub, byMod, byDay, byProjRaw] = await Promise.all([
 			aggregate(iterTurns(turns), from, to, 'subagent'),
 			aggregate(iterTurns(turns), from, to, 'model'),
 			aggregate(iterTurns(turns), from, to, 'day'),
 			aggregate(iterTurns(turns), from, to, 'project'),
 		]);
+		const byProj = args.anonymize ? anonymizeForSummary(byProjRaw) : byProjRaw;
 		console.log(formatSummary(bySub, byMod, byDay, byProj, args.period));
 		return;
 	}
 
 	let report = await aggregate(iterTurns(turns), from, to, args.by);
+	if (args.anonymize) report = anonymizeReport(report, args.by);
 	report = planMask(report, args.plan);
 
 	let output: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-agent-ledger",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "See exactly where your Claude Code budget goes — per subagent, per task.",
   "type": "module",
   "bin": {