@caius_kong/ccusage-dashboard 0.2.12 → 0.2.13

package/README.md

@@ -50,16 +50,17 @@ for you to open.
 npx @caius_kong/ccusage-dashboard --port 9000     # change port
 npx @caius_kong/ccusage-dashboard --budget 500    # monthly budget cap (default $300)
 npx @caius_kong/ccusage-dashboard --no-warm       # skip background warm-up
-npx @caius_kong/ccusage-dashboard --daemon        # run in the background (terminal exits, server keeps running)
-npx @caius_kong/ccusage-dashboard --stop          # stop a background instance
+npx @caius_kong/ccusage-dashboard --foreground   # run attached to this terminal (Ctrl+C stops it)
+npx @caius_kong/ccusage-dashboard --stop          # stop the background instance
 ```
 
 Once started, the launcher prints the dashboard URL — open it in your browser
 (no browser is auto-launched).
 
-**`--daemon`** starts the server detached so you can close the terminal and it keeps
-running; run `--stop` to shut it down. Running `--daemon` again reuses the running
-instance instead of starting a second one.
+By default the dashboard runs **in the background**: after printing its URL the
+launcher exits and the server keeps running, so you can close the terminal. Use
+`--stop` to shut it down; running it again reuses the already-running instance.
+`--foreground` keeps it attached to the terminal instead (Ctrl+C to stop).
 
 ## What it shows
 

package/bin/ccusage-ui.js

@@ -7,15 +7,13 @@
  * ccusage for all numbers, so the dashboard always matches ccusage.
  *
  * Modes:
- *   foreground (default) — the server runs attached to this terminal; Ctrl+C
- *                          stops it. A URL banner is printed when it is up.
- *   --daemon             — start the server detached in the background, print
- *                          the URL, and exit immediately. The server keeps
- *                          running after this terminal closes. If a server is
- *                          already up on the port, it reuses it instead of
- *                          starting a second one.
+ *   default            — start the server detached in the background, print
+ *                        the URL, and exit immediately. The server keeps running
+ *                        after this terminal closes. If a server is already up on
+ *                        the port, it reuses it instead of starting a second one.
+ *   --foreground       — run the server attached to this terminal (Ctrl+C stops it).
  *
- * Stop a daemon with:  npx @caius_kong/ccusage-dashboard --stop
+ * Stop a background instance with:  npx @caius_kong/ccusage-dashboard --stop
  */
 'use strict';
 
@@ -63,11 +61,12 @@ function argValue(name, fallback) {
 const host = argValue('--host', '127.0.0.1');
 const port = parseInt(argValue('--port', '8799'), 10);
 const url = `http://${host}:${port}`;
-const wantDaemon = rawArgs.includes('--daemon');
+const wantDaemon = !rawArgs.includes('--foreground'); // background by default
 const wantStop = rawArgs.includes('--stop');
+const wantForeground = rawArgs.includes('--foreground');
 
 // Filter launcher-only flags before forwarding to server.py.
-const serverArgs = rawArgs.filter((a) => !['--daemon', '--stop'].includes(a));
+const serverArgs = rawArgs.filter((a) => !['--daemon', '--stop', '--foreground'].includes(a));
 
 // --- daemon pid file (per host:port) ----------------------------------------
 function pidFile() {
@@ -104,7 +103,7 @@ function printBanner() {
   console.log(`  Open it manually:      ${url}`);
   console.log(line);
   if (wantDaemon) {
-    console.log(`  (background mode — stop with: npx @caius_kong/ccusage-dashboard --stop)`);
+    console.log(`  (background — stop with: npx @caius_kong/ccusage-dashboard --stop)`);
     console.log('');
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caius_kong/ccusage-dashboard",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "description": "One-command local dashboard for ccusage: today/week/month/custom cost by model, 30-day trend, monthly budget alert. Numbers straight from ccusage.",
   "license": "MIT",
   "type": "commonjs",