ai-spend-agent 0.6.0 → 0.7.0

package/README.md

@@ -3,11 +3,26 @@
 The full [aibill](https://github.com/futurastudio/ai-spend-agent) CLI.
 
 ```bash
+npx aibill init
+npx aibill statusline install # optional Claude Code cache-only status line
 npx ai-spend-agent
 # short alias
 npx aibill
 ```
 
+Run `npx aibill init` from a project to detect machine-wide local Claude Code
+and Codex history, print the first evidence-labeled personal receipt, and seed a private
+aggregate cache under `~/.aibill/cache/`. Init never replaces missing personal
+evidence with the bundled sample and never overwrites existing connected
+source or audit state.
+
+The optional status line is explicit and reversible. It installs a standalone
+Node-builtins-only runner at Claude user scope, rereads only the private
+aggregate cache, and never scans transcripts or contacts a provider from the
+hook. Subscription runway appears only when it was transcript-reported; `~`
+means API-equivalent value, and untilded `billed` money requires verified
+provider evidence. Remove it with `npx aibill statusline uninstall`.
+
 It reads local Claude Code and Codex metadata, labels API-equivalent estimates,
 and can optionally add official OpenAI or Anthropic provider-reported cost
 through an environment-variable reference. No product telemetry is sent.

package/dist/index.d.ts

@@ -4,7 +4,16 @@ export type CliResult = {
     stdout: string;
     stderr: string;
 };
-export declare function runCli(argv?: string[]): Promise<CliResult>;
+export type CliRuntimeOptions = {
+    /** Test/embedding override. Production always defaults to the OS home. */
+    homeDirectory?: string;
+    /** Test/embedding override. Packed production reads the built runtime asset. */
+    statuslineRunnerContents?: string | Uint8Array;
+    statuslineNow?: Date;
+    statuslineColumns?: number;
+    statuslineTimeZone?: string;
+};
+export declare function runCli(argv?: string[], runtime?: CliRuntimeOptions): Promise<CliResult>;
 /**
  * Full bin entrypoint (node guard, spinner, error voice, exit code).
  * Exported so the thin alias packages (`aispend`, `aireceipt`) run the EXACT