@alyibrahim/claude-statusline 1.4.7 → 1.5.1

package/README.md

@@ -1,7 +1,9 @@
 <div align="center">
 
-<img src=".github/assets/logo-light.svg#gh-light-mode-only" alt="claude-statusline" width="600">
-<img src=".github/assets/logo-dark.svg#gh-dark-mode-only" alt="claude-statusline" width="600">
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/AlyIbrahim1/claude-statusline/main/.github/assets/logo-dark.svg">
+  <img src="https://raw.githubusercontent.com/AlyIbrahim1/claude-statusline/main/.github/assets/logo-light.svg" alt="claude-statusline" width="600">
+</picture>
 
 [![CI](https://github.com/AlyIbrahim1/claude-statusline/actions/workflows/ci.yml/badge.svg)](https://github.com/AlyIbrahim1/claude-statusline/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@alyibrahim/claude-statusline)](https://www.npmjs.com/package/@alyibrahim/claude-statusline)
@@ -61,7 +63,7 @@ Done. The statusline configures itself automatically. Restart Claude Code to see
 
 ## Session History
 
-Track token usage, cost, and duration across every Claude Code session with a built-in analytics dashboard.
+Track token usage, cost, and duration across every Claude Code session. Choose between a **terminal-native TUI** or a **browser dashboard** — your preference is saved automatically.
 
 ![history dashboard](assets/dashboard-preview.png)
 
@@ -81,12 +83,70 @@ Session history is **enabled by default** on setup. Each session records:
 **Commands:**
 
 ```bash
-claude-statusline history          # Open the analytics dashboard
-claude-statusline enable-history   # Enable session tracking
-claude-statusline disable-history  # Disable session tracking
+claude-statusline history                   # Open dashboard in saved mode (default: web)
+claude-statusline history --mode terminal   # Switch to terminal TUI (persisted)
+claude-statusline history --mode web        # Switch to browser dashboard (persisted)
+claude-statusline enable-history            # Enable session tracking
+claude-statusline disable-history           # Disable session tracking
 ```
 
-Data is stored at `~/.claude/statusline-history.jsonl`. The dashboard opens in your browser and supports project filtering and light/dark theme toggle.
+Data is stored at `~/.claude/statusline-history.jsonl`.
+
+### Claude Code slash commands
+
+History commands are also available directly inside Claude Code as slash commands:
+
+- `/history`
+- `/history-enable`
+- `/history-disable`
+- `/history-mode <web|terminal>`
+
+Project contributors get these from the repo at `.claude/commands/`.
+Global npm installs copy them to `~/.claude/commands/` automatically.
+
+### Terminal TUI
+
+`--mode terminal` opens an interactive full-screen dashboard directly in your terminal — no browser required. Requires the native Rust binary (falls back to web dashboard with a warning if unavailable).
+
+```
+┌─ claude-statusline history ──────────────────────────────────────────────┐
+│ Sessions: 42   Tokens: 8.3M   Cost: $12.47                               │
+└──────────────────────────────────────────────────────────────────────────┘
+┌──────────────────────────────────────────────────────────────────────────┐
+│ Filter: [All Projects ▾]                                                 │
+└──────────────────────────────────────────────────────────────────────────┘
+┌──────────────────────────────────────────────────────────────────────────┐
+│  Project              Model               Started          Dur   Tok   Cost│
+│                                                                           │
+│> my-web-app           claude-sonnet-4-6   2026-04-02 14:  32m   842k  $2.14│
+│  cli-tool             claude-opus-4-6     2026-04-01 09:  1h4m  1.2M  $5.60│
+│  data-pipeline        claude-haiku-4-5    2026-03-31 17:  18m   220k  $0.44│
+│  my-web-app           claude-sonnet-4-6   2026-03-30 11:  45m   990k  $2.89│
+│  api-server           claude-sonnet-4-6   2026-03-29 08:  2h1m  2.1M  $8.33│
+│                                                                           │
+└──────────────────────────────────────────────────────────────────────────┘
+┌──────────────────────────────────────────────────────────────────────────┐
+│ up/down or j/k: move   f: filter   Enter: apply   Esc: close   q: quit   │
+└──────────────────────────────────────────────────────────────────────────┘
+```
+
+Press `f` to open the project filter popup:
+
+```
+              ┌─ Filter by Project ──────────┐
+              │ ██ All Projects ██           │
+              │   api-server                 │
+              │   cli-tool                   │
+              │   data-pipeline              │
+              │   my-web-app                 │
+              └──────────────────────────────┘
+```
+
+Rows are color-coded by exit reason: green = normal, yellow = interrupted, orange = pending.
+
+### Web Dashboard
+
+`--mode web` (the default) opens a browser-based dashboard with project filtering and light/dark theme toggle.
 
 ---
 
@@ -118,7 +178,7 @@ See [PLATFORMS.md](PLATFORMS.md) for the full compatibility guide, per-platform
 | Subagent counter | Counts active agents from todos dir | — |
 | Session tokens | Real-time via JSONL offset cache, split I/O (`X↓ Y↑`) | Stale stdin snapshot or none |
 | Session commits | Tracks git commits made this session | — |
-| Session history | Analytics dashboard with per-project filtering, zero dependencies | — |
+| Session history | Terminal TUI + browser dashboard, per-project filtering, zero dependencies | — |
 
 ---
 
@@ -146,6 +206,8 @@ npm uninstall -g @alyibrahim/claude-statusline
 
 > Always run `claude-statusline uninstall` first — it removes the `statusLine` entry from `~/.claude/settings.json` before the files are deleted.
 
+`npm uninstall -g @alyibrahim/claude-statusline` also removes the four history slash command files installed by this package from `~/.claude/commands/`, without touching other custom commands.
+
 ---
 
 <div align="center">

package/bin/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 'use strict';
-const { setup, toggleHistory } = require('../scripts/setup');
+const { setup, toggleHistory, getDashboardMode, setDashboardMode } = require('../scripts/setup');
 const { uninstall } = require('../scripts/uninstall');
 const config = require('../scripts/config');
 const { getSettingsPath } = config;
@@ -16,8 +16,89 @@ Commands:
   enable-history   Enable tracking session analytics to JSONL (default on setup)
   disable-history  Remove history tracking hooks from Claude settings
   history          Open the session analytics dashboard
+                   --mode web|terminal (persist dashboard mode preference)
 `.trim();
 
+const TERMINAL_FALLBACK_WARNING = [
+  '[claude-statusline] terminal mode requires the native binary.',
+  'Falling back to web dashboard. To install the binary, run:',
+  '  npm install -g @alyibrahim/claude-statusline'
+].join('\n');
+
+function parseHistoryMode(args) {
+  let mode;
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--mode') {
+      const value = args[i + 1];
+      if (!value) {
+        return { ok: false, error: 'Missing value for --mode. Expected "web" or "terminal".' };
+      }
+      mode = value;
+      i++;
+      continue;
+    }
+    if (arg.startsWith('--mode=')) {
+      mode = arg.slice('--mode='.length);
+      continue;
+    }
+    return { ok: false, error: `Unknown history option: ${arg}` };
+  }
+
+  if (mode !== undefined && mode !== 'web' && mode !== 'terminal') {
+    return { ok: false, error: `Invalid mode: ${mode}. Expected "web" or "terminal".` };
+  }
+
+  return { ok: true, mode };
+}
+
+function runHistory() {
+  const parseResult = parseHistoryMode(process.argv.slice(3));
+  if (!parseResult.ok) {
+    console.error('Error:', parseResult.error);
+    process.exit(1);
+  }
+
+  let mode;
+  if (parseResult.mode) {
+    const saved = setDashboardMode(parseResult.mode);
+    if (!saved.ok) {
+      console.error('Error:', saved.error);
+      process.exit(1);
+    }
+    mode = parseResult.mode;
+  } else {
+    const saved = getDashboardMode();
+    if (!saved.ok) {
+      console.error('Error:', saved.error);
+      process.exit(1);
+    }
+    mode = saved.mode;
+  }
+
+  const binaryPath = config.resolveBinary();
+  const scriptPath = path.resolve(__dirname, '../statusline.js');
+
+  if (mode === 'terminal') {
+    if (binaryPath) {
+      const child = spawnSync(binaryPath, ['history', '--terminal'], { stdio: 'inherit' });
+      process.exit(child.status || 0);
+    }
+
+    console.error(TERMINAL_FALLBACK_WARNING);
+    const child = spawnSync(process.execPath, [scriptPath, 'history'], { stdio: 'inherit' });
+    process.exit(child.status || 0);
+  }
+
+  if (binaryPath) {
+    const child = spawnSync(binaryPath, ['history'], { stdio: 'inherit' });
+    process.exit(child.status || 0);
+  }
+
+  const child = spawnSync(process.execPath, [scriptPath, 'history'], { stdio: 'inherit' });
+  process.exit(child.status || 0);
+}
+
 const cmd = process.argv[2];
 
 if (cmd === 'setup') {
@@ -52,7 +133,7 @@ if (cmd === 'setup') {
   }
   console.log(`✓ History tracking disabled from ${result.settingsPath}`);
 
-} else if (cmd === 'hook' || cmd === 'history') {
+} else if (cmd === 'hook') {
   const binaryPath = config.resolveBinary();
   const scriptPath = path.resolve(__dirname, '../statusline.js');
   
@@ -66,6 +147,9 @@ if (cmd === 'setup') {
     process.exit(child.status || 0);
   }
 
+} else if (cmd === 'history') {
+  runHistory();
+
 } else if (cmd === undefined) {
   console.log(USAGE);
   process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alyibrahim/claude-statusline",
-  "version": "1.4.7",
+  "version": "1.5.1",
   "description": "Rich statusline for Claude Code — model, context bar, real-time token tracking, git branch, rate limits, and session stats. Rust binary, ~5ms startup.",
   "keywords": [
     "claude",
@@ -56,11 +56,11 @@
     "open": "^10.1.0"
   },
   "optionalDependencies": {
-    "@alyibrahim/claude-statusline-linux-x64": "1.4.7",
-    "@alyibrahim/claude-statusline-linux-arm64": "1.4.7",
-    "@alyibrahim/claude-statusline-darwin-x64": "1.4.7",
-    "@alyibrahim/claude-statusline-darwin-arm64": "1.4.7",
-    "@alyibrahim/claude-statusline-win32-x64": "1.4.7"
+    "@alyibrahim/claude-statusline-linux-x64": "1.5.1",
+    "@alyibrahim/claude-statusline-linux-arm64": "1.5.1",
+    "@alyibrahim/claude-statusline-darwin-x64": "1.5.1",
+    "@alyibrahim/claude-statusline-darwin-arm64": "1.5.1",
+    "@alyibrahim/claude-statusline-win32-x64": "1.5.1"
   },
   "devDependencies": {
     "jest": "^29.0.0"

package/scripts/postinstall.js

@@ -1,11 +1,20 @@
 #!/usr/bin/env node
 'use strict';
 const fs = require('fs');
+const path = require('path');
 const { setup } = require('./setup');
 const config = require('./config');
 try {
   const result = setup({ force: false });
   if (result.settingsPath === null) process.exit(0); // non-global install, skip silently
+
+  const sourceDir = path.join(__dirname, '..', '.claude', 'commands');
+  const commandsDir = path.join(path.dirname(result.settingsPath), 'commands');
+  fs.mkdirSync(commandsDir, { recursive: true });
+  for (const f of fs.readdirSync(sourceDir)) {
+    fs.copyFileSync(path.join(sourceDir, f), path.join(commandsDir, f));
+  }
+
   if (!result.ok) {
     console.warn('\n⚠  claude-statusline: auto-setup failed:', result.error);
     console.warn('   Run manually: claude-statusline setup\n');

package/scripts/preuninstall.js

@@ -1,5 +1,18 @@
 #!/usr/bin/env node
 'use strict';
+const fs = require('fs');
+const path = require('path');
+const { getSettingsPath } = require('./config');
 const { uninstall } = require('./uninstall');
-try { uninstall(); } catch (e) {} // fully silent — best-effort cleanup
+
+const FILES = ['history.md', 'history-enable.md', 'history-disable.md', 'history-mode.md'];
+
+try {
+	const commandsDir = path.join(path.dirname(getSettingsPath()), 'commands');
+	for (const f of FILES) {
+		const dest = path.join(commandsDir, f);
+		if (fs.existsSync(dest)) fs.unlinkSync(dest);
+	}
+	uninstall();
+} catch (e) {} // fully silent — best-effort cleanup
 process.exit(0);

package/scripts/setup.js

@@ -109,4 +109,47 @@ function toggleHistory(enable) {
   return { ok: true, settingsPath };
 }
 
-module.exports = { setup, toggleHistory, updateHooks };
+function getDashboardMode() {
+  const settingsPath = getSettingsPath();
+  if (!fs.existsSync(settingsPath)) {
+    return { ok: true, settingsPath, mode: 'web' };
+  }
+
+  let settings = {};
+  try {
+    settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+  } catch (e) {
+    return { ok: false, error: 'settings.json contains invalid JSON - fix manually then re-run.' };
+  }
+
+  const mode = settings.dashboardMode === 'terminal' ? 'terminal' : 'web';
+  return { ok: true, settingsPath, mode };
+}
+
+function setDashboardMode(mode) {
+  if (mode !== 'web' && mode !== 'terminal') {
+    return { ok: false, error: 'Invalid mode. Expected "web" or "terminal".' };
+  }
+
+  const settingsPath = getSettingsPath();
+  let settings = {};
+  if (fs.existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+    } catch (e) {
+      return { ok: false, error: 'settings.json contains invalid JSON - fix manually then re-run.' };
+    }
+  }
+
+  settings.dashboardMode = mode;
+
+  try {
+    atomicWrite(settingsPath, settings);
+  } catch (err) {
+    return { ok: false, error: err.message };
+  }
+
+  return { ok: true, settingsPath, mode };
+}
+
+module.exports = { setup, toggleHistory, updateHooks, getDashboardMode, setDashboardMode };