@caius_kong/ccusage-dashboard 0.2.12 → 0.2.14

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/lib/index.html

@@ -55,7 +55,9 @@
   .range button{background:var(--panel-2);border:1px solid var(--border);color:var(--text);border-radius:6px;padding:5px 12px;cursor:pointer;font-size:12px}
   .range button:hover{border-color:var(--accent)}
   .range button.active{background:var(--accent);border-color:var(--accent);color:#0d1117;font-weight:600}
-  .sessid{font-variant-numeric:tabular-nums;letter-spacing:.3px}
+  .sessid{font-variant-numeric:tabular-nums;letter-spacing:.3px;cursor:pointer;transition:background .15s,border-color .15s,color .15s}
+  .sessid:hover{background:var(--accent);border-color:var(--accent);color:#0d1117}
+  .sessid.copied{background:var(--green);border-color:var(--green);color:#0d1117}
   .budget-band{margin:2px 0 14px;background:var(--panel-2);border-radius:8px;padding:12px 16px;display:flex;flex-direction:column;gap:8px}
   .budget-band .bl{display:flex;justify-content:space-between;font-size:13px;color:var(--muted)}
   .budget-band .bl b{color:var(--text)}
@@ -133,6 +135,24 @@ function fmtTok(n){
 }
 function fmtPct(n){return n==null?"–":n.toFixed(1)+"%";}
 function esc(s){const d=document.createElement("div");d.textContent=s;return d.innerHTML;}
+async function copySessionId(id, ev){
+  ev.stopPropagation();
+  const el=ev.currentTarget; // capture before any await; currentTarget is nulled after dispatch
+  try{
+    await navigator.clipboard.writeText(id);
+  }catch(e){
+    // fallback for non-secure contexts / older browsers
+    const ta=document.createElement("textarea");
+    ta.value=id;ta.style.position="fixed";ta.style.opacity="0";
+    document.body.appendChild(ta);ta.select();
+    try{document.execCommand("copy");}catch(_){}
+    document.body.removeChild(ta);
+  }
+  el.classList.add("copied");
+  const old=el.textContent;
+  el.textContent="✓ copied";
+  setTimeout(()=>{el.textContent=old;el.classList.remove("copied");},1200);
+}
 
 function renderModels(data){
   const total=data.totalCost||0;
@@ -190,9 +210,11 @@ function renderSessions(data){
   $("sessRange").textContent=`${total} sessions`;
   if(!list.length){$("sessionsList").innerHTML='<div class="empty">no sessions in range</div>';return;}
   $("sessionsList").innerHTML=list.map(s=>{
+    const shortId=s.id.slice(0,8);
+    const idPill=`<span class="pill sessid" title="click to copy full session id" onclick="copySessionId('${s.id.replace(/[\\']/g,"\\$&")}',event)">${esc(shortId)}</span>`;
     const label = s.hasCwd
-      ? `<span class="name" title="workdir: ${esc(s.cwd||s.projectKey)}">${esc(s.dirName||s.id.slice(0,8))} <span class="pill sessid">${esc(s.id.slice(0,8))}</span></span>`
-      : `<span class="name muted" title="no workdir found for this ${esc(s.agent)} session">${esc(s.id.slice(0,8))}</span>`;
+      ? `<span class="name" title="workdir: ${esc(s.cwd||s.projectKey)}">${esc(s.dirName||shortId)} ${idPill}</span>`
+      : `<span class="name muted" title="no workdir found for this ${esc(s.agent)} session">${idPill}</span>`;
     const last=(s.lastActivity||"").slice(0,10);
     return `<div class="row">
       <div class="row-top"><span>${label} <span class="pill">${esc(s.agent)}</span></span><span class="cost">${fmtUsd(s.cost)}</span></div>

package/lib/server.py

@@ -202,14 +202,13 @@ def sessions(since_days: int = 30, period: str = "", from_date: str = "", to_dat
     Filtering: pass `period` in ("today" | "week" | "month") OR an explicit
     date range via `from_date`/`to_date` (YYYY-MM-DD). `since_days` is kept for
     backward compatibility with the old 7d/30d/90d/all selector.
-    """
-    data = run_ccusage(
-        ["session", "--by-agent", "--json", "--offline"],
-        TTL["/api/sessions"],
-    )
-    rows = data.get("session") or []
 
-    # ---- choose the cutoff window ----------------
+    The window is passed to ccusage as --since/--until so it filters by usage
+    EVENT date (entry.date) before summarising, exactly like the CLI session
+    report. Filtering rows ourselves by lastActivity would keep a whole session's
+    lifetime cost even when only a few events fall in the window, inflating the
+    total (observed: today $229 vs ccusage's true $0.09).
+    """
     today = date.today()
     lo = hi = None
     if from_date and to_date:
@@ -232,20 +231,17 @@ def sessions(since_days: int = 30, period: str = "", from_date: str = "", to_dat
         lo = today - timedelta(days=since_days)
         hi = today
 
+    ccusage_args = ["session", "--json", "--offline"]
+    if lo and hi:
+        ccusage_args += ["--since", lo.isoformat(), "--until", hi.isoformat()]
+    data = run_ccusage(ccusage_args, TTL["/api/sessions"])
+    rows = data.get("session") or []
+
     out = []
     for r in rows:
         meta = r.get("metadata") or {}
         sid = r.get("period")
         last_activity = meta.get("lastActivity") or ""
-        # date filter by last activity against [lo, hi]
-        if last_activity:
-            try:
-                act_date = date.fromisoformat(last_activity[:10])
-            except ValueError:
-                act_date = None
-            if act_date is not None:
-                if act_date < lo or act_date > hi:
-                    continue
         project_raw = meta.get("projectPath") or ""
         agent_name = r.get("agent", "?")
         cwd = ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caius_kong/ccusage-dashboard",
-  "version": "0.2.12",
+  "version": "0.2.14",
   "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",