@jeganwrites/claudash 1.0.4 → 1.0.5

package/README.md

@@ -40,16 +40,17 @@ Zero pip dependencies. Single SQLite file. Single HTML page.
 - Claude Code installed and at least one session run
 - macOS or Linux (Windows: core features work, browser tracking not supported)
 
-### Fastest (via npx — no install needed)
+### Via npm (recommended)
 
 ```bash
-npx claudash
+npm install -g @jeganwrites/claudash
+claudash
 ```
 
 Requires Node.js 16+ and Python 3.8+.
 Auto-installs, opens browser, detects your Claude Code data.
 
-### Manual install (local Mac/Linux)
+### Or git clone
 
 ```bash
 git clone https://github.com/pnjegan/claudash
@@ -90,6 +91,14 @@ python3 tools/mac-sync.py
 # */5 * * * * python3 /path/to/oauth_sync.py
 ```
 
+### Auto-sync daemon (runs every 5 minutes)
+
+```bash
+python3 cli.py sync-daemon
+# Or run in background:
+nohup python3 cli.py sync-daemon > /tmp/claudash-sync.log 2>&1 &
+```
+
 Full setup walkthrough in [SETUP.md](SETUP.md).
 
 ## Keeping it running
@@ -161,6 +170,7 @@ page to modify accounts.
 | `python3 cli.py mcp` | Print the MCP settings.json snippet + smoke-test the server |
 | `python3 cli.py keys` | Print `dashboard_key` and `sync_token` (sensitive) |
 | `python3 cli.py claude-ai` | Show claude.ai browser tracking status |
+| `python3 cli.py sync-daemon` | Auto-sync browser data every 5 min (foreground) |
 
 ## How Claudash differs from similar tools
 
@@ -236,6 +246,7 @@ Every mutating endpoint requires `X-Dashboard-Key` (from `python3 cli.py keys`).
 ## Documentation
 
 - [SETUP.md](SETUP.md) — first-time setup guide
+- [docs/HOOKS_SETUP.md](docs/HOOKS_SETUP.md) — Claude Code hooks integration
 - [CHANGELOG.md](CHANGELOG.md) — version history
 - [CONTRIBUTING.md](CONTRIBUTING.md) — how to contribute
 

package/analyzer.py

@@ -739,17 +739,23 @@ def compute_efficiency_score(conn, account="all"):
     window_score = max(0, min(100, window_score))
 
     # Dimension 4: Floundering rate
+    # Count DISTINCT sessions (not events) with floundering, filtered by account
     total_sessions = conn.execute(
         f"SELECT COUNT(DISTINCT session_id) FROM sessions WHERE {where}",
         params
     ).fetchone()[0] or 1
+    flounder_where = "pattern_type='floundering' AND detected_at > ?"
+    flounder_params = [cutoff]
+    if account and account != "all":
+        flounder_where += " AND account = ?"
+        flounder_params.append(account)
     flounder_sessions = conn.execute(
-        "SELECT COUNT(DISTINCT session_id) FROM waste_events "
-        "WHERE pattern_type='floundering' AND detected_at > ?",
-        [cutoff]
+        f"SELECT COUNT(DISTINCT session_id) FROM waste_events WHERE {flounder_where}",
+        flounder_params
     ).fetchone()[0]
-    flounder_rate = flounder_sessions / total_sessions
-    flounder_score = round((1 - min(flounder_rate * 10, 1)) * 100)
+    # Linear penalty: 0% flounder = 100, 1% = 90, 5% = 50, 10%+ = 0
+    flounder_pct = flounder_sessions / total_sessions * 100
+    flounder_score = max(0, round(100 - flounder_pct * 10))
 
     # Dimension 5: Compaction discipline
     compact_events = conn.execute(

package/bin/claudash.js

@@ -1,28 +1,36 @@
 #!/usr/bin/env node
 
 const { execSync, spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
 
+const VERSION = '1.0.5';
+const REPO = 'https://github.com/pnjegan/claudash';
+const INSTALL_DIR = path.join(os.homedir(), '.claudash');
+
+// Parse args FIRST — before any other code runs.
+// This prevents macOS `open` from ever receiving --help and misinterpreting it.
 const args = process.argv.slice(2);
+
 if (args.includes('--help') || args.includes('-h')) {
-  console.log('Claudash v1.0 — Claude Code usage intelligence');
+  console.log('Claudash v' + VERSION + ' — Claude Code usage intelligence');
   console.log('');
-  console.log('Usage: claudash [options]');
+  console.log('Usage: claudash [--port <n>]');
   console.log('');
-  console.log('Options:');
-  console.log('  --port <n>    Port to run on (default: 8080)');
-  console.log('  --help        Show this help');
+  console.log('  --port <n>    Port to serve on (default: 8080)');
+  console.log('  --no-browser  Skip auto-opening browser');
+  console.log('  --help, -h    Show this help');
   console.log('');
   console.log('GitHub: https://github.com/pnjegan/claudash');
+  console.log('npm:    npm install -g @jeganwrites/claudash');
   process.exit(0);
 }
 
-const path = require('path');
-const fs = require('fs');
-const os = require('os');
-
-const VERSION = '1.0.0';
-const REPO = 'https://github.com/pnjegan/claudash';
-const INSTALL_DIR = path.join(os.homedir(), '.claudash');
+if (args.includes('--version') || args.includes('-v')) {
+  console.log(VERSION);
+  process.exit(0);
+}
 
 function checkPython() {
   try {
@@ -58,6 +66,19 @@ function checkClaudeData() {
   return found;
 }
 
+function isPortInUse(port) {
+  try {
+    execSync(
+      'lsof -ti:' + port + ' 2>/dev/null || ' +
+      'netstat -an 2>/dev/null | grep ":' + port + ' " | grep LISTEN',
+      { stdio: 'pipe' }
+    );
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
 function installClaudash() {
   if (fs.existsSync(path.join(INSTALL_DIR, 'cli.py'))) {
     try {
@@ -93,22 +114,17 @@ function openBrowser(port) {
 }
 
 function main() {
-  const args = process.argv.slice(2);
-
-  if (args.includes('--help') || args.includes('-h')) {
-    console.log('Claudash v' + VERSION + ' — Claude Code usage intelligence');
-    console.log('');
-    console.log('Usage: npx claudash [options]');
-    console.log('');
-    console.log('Options:');
-    console.log('  --port=N    Dashboard port (default: 8080)');
-    console.log('  --no-browser  Skip auto-opening browser');
-    console.log('  --help      Show this help');
-    process.exit(0);
+  // Support both --port=N and --port N
+  let port = '8080';
+  const portEq = args.find(a => a.startsWith('--port='));
+  if (portEq) {
+    port = portEq.split('=')[1];
+  } else {
+    const portIdx = args.indexOf('--port');
+    if (portIdx !== -1 && args[portIdx + 1]) {
+      port = args[portIdx + 1];
+    }
   }
-
-  const portArg = args.find(a => a.startsWith('--port='));
-  const port = portArg ? portArg.split('=')[1] : '8080';
   const noBrowser = args.includes('--no-browser');
 
   console.log('Claudash v' + VERSION);
@@ -118,6 +134,13 @@ function main() {
   checkClaudeData();
   installClaudash();
 
+  if (isPortInUse(port)) {
+    console.log('Port ' + port + ' is already in use.');
+    console.log('Try: claudash --port 8081');
+    console.log('Or kill the process: lsof -ti:' + port + ' | xargs kill');
+    process.exit(1);
+  }
+
   console.log('Starting dashboard on http://localhost:' + port + ' ...');
   if (!noBrowser) {
     openBrowser(port);

package/cli.py

@@ -42,6 +42,7 @@ Commands:
   keys --rotate Regenerate dashboard_key (invalidates existing browser sessions)
   init          First-run setup wizard (3 questions, then start)
   claude-ai     Show claude.ai browser tracking status
+  sync-daemon   Auto-sync browser data every 5 minutes (background)
   claude-ai --sync-token          Print sync token (for tools/mac-sync.py)
   claude-ai --setup <account_id>  Paste a claude.ai session key interactively
 
@@ -882,6 +883,13 @@ def cmd_export():
     print(f"Exported {len(rows)} rows to {outpath}")
 
 
+def cmd_sync_daemon():
+    """Run the sync daemon that pushes claude.ai browser data every 5 min."""
+    daemon = os.path.join(os.path.dirname(os.path.abspath(__file__)),
+                          "tools", "sync-daemon.py")
+    os.execv(sys.executable, [sys.executable, daemon])
+
+
 def cmd_keys():
     """Print dashboard_key and sync_token. Sensitive — do not paste into
     screenshots, chat transcripts, or shared terminals."""
@@ -1019,6 +1027,7 @@ def main():
         "mcp": cmd_mcp,
         "keys": cmd_keys,
         "claude-ai": cmd_claude_ai,
+        "sync-daemon": cmd_sync_daemon,
     }
 
     handler = commands.get(cmd)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeganwrites/claudash",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Claude Code usage intelligence dashboard",
   "bin": {
     "claudash": "./bin/claudash.js"
@@ -8,13 +8,7 @@
   "scripts": {
     "start": "node bin/claudash.js"
   },
-  "keywords": [
-    "claude",
-    "claude-code",
-    "usage",
-    "dashboard",
-    "ai"
-  ],
+  "keywords": ["claude", "claude-code", "usage", "dashboard", "ai"],
   "author": "Jegan Nagarajan",
   "license": "MIT",
   "repository": {

package/tools/hooks/post-session.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Claudash post-session hook
+# Add to ~/.claude/settings.json PostToolUse hooks
+# Records session cost after each Claude Code session
+
+CLAUDASH_DIR="${CLAUDASH_DIR:-$HOME/.claudash}"
+DASHBOARD_URL="${CLAUDASH_URL:-http://localhost:8080}"
+
+# Trigger a scan to pick up the new session
+KEY=$(python3 "$CLAUDASH_DIR/cli.py" keys 2>/dev/null | grep dashboard_key | awk '{print $3}')
+curl -s -X POST "$DASHBOARD_URL/api/scan" \
+  -H "X-Dashboard-Key: $KEY" \
+  > /dev/null 2>&1
+
+echo "[claudash] Session recorded"

package/tools/sync-daemon.py

@@ -0,0 +1,54 @@
+#!/usr/bin/env python3
+"""
+Claudash sync daemon — runs in background,
+pushes claude.ai browser data every 5 minutes.
+Works on macOS (uses mac-sync.py) or any OS (uses oauth_sync.py).
+"""
+import time
+import os
+import sys
+import subprocess
+import platform
+
+INTERVAL = 300  # 5 minutes
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+
+
+def get_sync_script():
+    if platform.system() == "Darwin":
+        mac_sync = os.path.join(SCRIPT_DIR, "mac-sync.py")
+        if os.path.exists(mac_sync):
+            return mac_sync
+    return os.path.join(SCRIPT_DIR, "oauth_sync.py")
+
+
+def run_sync():
+    script = get_sync_script()
+    try:
+        result = subprocess.run(
+            [sys.executable, script],
+            capture_output=True, text=True, timeout=30
+        )
+        if result.returncode == 0:
+            print(f"[sync] OK: {result.stdout.strip()[:200]}")
+        else:
+            print(f"[sync] Error: {result.stderr.strip()[:200]}")
+    except subprocess.TimeoutExpired:
+        print("[sync] Timeout after 30s")
+    except Exception as e:
+        print(f"[sync] Failed: {e}")
+
+
+if __name__ == "__main__":
+    print(f"Claudash sync daemon starting (every {INTERVAL//60} min)")
+    print(f"Using: {get_sync_script()}")
+    print("Press Ctrl+C to stop")
+    print()
+
+    run_sync()  # run immediately on start
+    try:
+        while True:
+            time.sleep(INTERVAL)
+            run_sync()
+    except KeyboardInterrupt:
+        print("\nSync daemon stopped.")