fix!: add offline mode support to statusline command (ccusage#471)

* fix\!: add offline mode support to statusline command

BREAKING CHANGE: statusline command now accepts CLI arguments

- Add --offline flag to statusline command for cached pricing data usage

- Pass offline flag to all data loading functions (loadSessionUsageById, loadDailyUsageData, loadSessionBlockData)

- Update documentation with offline mode configuration examples

- Enables faster performance without network dependencies to LiteLLM API

This is a breaking change as the statusline command signature has changed from accepting no arguments to accepting the --offline flag. However, existing configurations will continue to work without modification.

* fix\!: make offline mode default for statusline command

BREAKING CHANGE: statusline now defaults to offline mode for better performance

- Set offline mode as default (true) for statusline command

- Update documentation to reflect offline as default behavior

- Users can opt-in to online mode with --no-offline flag

- Provides instant response times without network latency

This change prioritizes performance for the statusline which needs to be responsive. The cached pricing data is sufficient for most use cases and eliminates network dependencies.

* simplified test statusline

Author: ryoppippi

docs/guide/statusline.md

@@ -28,6 +28,22 @@ Add this to your `~/.claude/settings.json` or `~/.config/claude/settings.json`:
 }
 ```
 
+By default, statusline uses **offline mode** with cached pricing data for optimal performance.
+
+### Online Mode (Optional)
+
+If you need the latest pricing data from LiteLLM API, you can explicitly enable online mode:
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "bun x ccusage statusline --no-offline", // Fetches latest pricing from API
+    "padding": 0
+  }
+}
+```
+
 ## Output Format
 
 The statusline displays a compact, single-line summary:
@@ -59,6 +75,8 @@ The statusline command:
 - Identifies the active 5-hour billing block
 - Calculates real-time burn rates and projections
 - Outputs a single line suitable for status bar display
+- **Uses offline mode by default** for instant response times without network dependencies
+- Can be configured to use online mode with `--no-offline` for latest pricing data
 
 ## Beta Notice
 

package.json

@@ -52,8 +52,7 @@
 		"release": "bun lint && bun typecheck && vitest run && bun run build && bumpp",
 		"start": "bun run ./src/index.ts",
 		"test": "TZ=UTC vitest",
-		"test:statusline": "cat test/statusline-test.json | bun run ./src/index.ts statusline",
-		"test:statusline:dev": "cat test/statusline-test.json | bun run start statusline",
+		"test:statusline": "cat test/statusline-test.json | bun run start statusline",
 		"typecheck": "tsgo --noEmit"
 	},
 	"devDependencies": {

src/commands/statusline.ts

@@ -3,6 +3,7 @@ import getStdin from 'get-stdin';
 import { define } from 'gunshi';
 import pc from 'picocolors';
 import { calculateBurnRate } from '../_session-blocks.ts';
+import { sharedArgs } from '../_shared-args.ts';
 import { statuslineHookJsonSchema } from '../_types.ts';
 import { formatCurrency } from '../_utils.ts';
 import { calculateTotals } from '../calculate-cost.ts';
@@ -28,8 +29,13 @@ function formatRemainingTime(remaining: number): string {
 export const statuslineCommand = define({
 	name: 'statusline',
 	description: 'Display compact status line for Claude Code hooks (Beta)',
-	args: {},
-	async run() {
+	args: {
+		offline: {
+			...sharedArgs.offline,
+			default: true, // Default to offline mode for faster performance
+		},
+	},
+	async run(ctx) {
 		// Set logger to silent for statusline output
 		logger.level = 0;
 
@@ -61,7 +67,7 @@ export const statuslineCommand = define({
 		// Load current session's cost by finding the specific JSONL file
 		let sessionCost: number | null = null;
 		try {
-			const sessionData = await loadSessionUsageById(sessionId, { mode: 'auto' });
+			const sessionData = await loadSessionUsageById(sessionId, { mode: 'auto', offline: ctx.values.offline });
 			if (sessionData != null) {
 				sessionCost = sessionData.totalCost;
 			}
@@ -80,6 +86,7 @@ export const statuslineCommand = define({
 				since: todayStr,
 				until: todayStr,
 				mode: 'auto',
+				offline: ctx.values.offline,
 			});
 
 			if (dailyData.length > 0) {
@@ -97,6 +104,7 @@ export const statuslineCommand = define({
 		try {
 			const blocks = await loadSessionBlockData({
 				mode: 'auto',
+				offline: ctx.values.offline,
 			});
 
 			// Only identify blocks if we have data