claude-view 0.8.0 → 0.11.0

package/README.md

@@ -1,46 +1,96 @@
+<div align="center">
+
 # claude-view
 
-Browse and search your Claude Code sessions in a beautiful local web UI.
+**You have 10 Claude sessions running right now. What are they doing?**
+
+<p>
+  <a href="https://www.npmjs.com/package/claude-view"><img src="https://img.shields.io/npm/v/claude-view.svg" alt="npm version"></a>
+  <a href="https://claudeview.ai"><img src="https://img.shields.io/badge/Website-claudeview.ai-orange" alt="Website"></a>
+  <a href="https://github.com/tombelieber/claude-view/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+  <img src="https://img.shields.io/badge/Platform-macOS-lightgrey.svg" alt="macOS">
+  <a href="https://github.com/tombelieber/claude-view/stargazers"><img src="https://img.shields.io/github/stars/tombelieber/claude-view?style=social" alt="GitHub stars"></a>
+</p>
+
+</div>
+
+Behind every "thinking..." spinner, Claude is spawning sub-agents, calling MCP servers, running skills, firing hooks — and you can't see any of it.
+
+**You're paying $200/mo for Claude Code. You deserve a dashboard.**
 
-## Quick Start
+<div align="center">
 
 ```bash
-npx claude-view
+curl -fsSL https://raw.githubusercontent.com/tombelieber/claude-view/main/install.sh | sh
 ```
 
-This downloads the pre-built binary for your platform, caches it locally, and starts a local web server. Open the printed URL in your browser to explore your Claude Code sessions.
+**One command. Every session visible. Real-time.**
+
+</div>
+
+---
+
+## Install
+
+| Method | Command |
+|--------|---------|
+| **Shell** (recommended) | `curl -fsSL https://raw.githubusercontent.com/tombelieber/claude-view/main/install.sh \| sh` |
+| **npx** | `npx claude-view` |
+
+---
 
-## What It Does
+## What You Get
 
-- Reads your local `~/.claude/` session files (JSONL)
-- Indexes them into a local SQLite database for fast search
-- Serves a React UI at `http://localhost:47892`
-- Everything stays on your machine -- no data is sent anywhere
+- **Live session cards** — see what every session is working on, right now
+- **Notification sounds** — get pinged when a session finishes or needs input
+- **Context gauge** — real-time context window usage per session
+- **Cache warm countdown** — time your messages to save tokens
+- **Cost tracking** — per-session and aggregate spend with cache savings
+- **Sub-agent visualization** — see the full agent tree, tool calls, MCP invocations
+- **Full-text search** — search across all sessions, messages, tool calls, file paths
+- **Analytics** — activity heatmap, cost ROI, model comparison, AI Fluency Score
+- **Rich chat history** — every conversation rendered with markdown, code blocks, tool calls
+
+---
+
+## How It Works
+
+On first run, `npx claude-view` downloads a platform-specific Rust binary (~10 MB) from GitHub Releases. The binary is cached at `~/.cache/claude-view/` so subsequent runs start instantly.
+
+Everything stays on your machine. Zero telemetry, zero cloud, zero network requests.
+
+---
 
 ## Configuration
 
 | Env Variable | Default | Description |
-|---|---|---|
+| --- | --- | --- |
 | `CLAUDE_VIEW_PORT` | `47892` | Port for the local server |
 | `PORT` | `47892` | Alternative port override |
 
 ## Supported Platforms
 
 | OS | Architecture |
-|---|---|
+| --- | --- |
 | macOS | Apple Silicon (arm64), Intel (x64) |
 | Linux | x64 |
 | Windows | x64 |
 
-## How It Works
-
-On first run, `npx claude-view` downloads a platform-specific tarball from GitHub Releases containing a compiled Rust binary and bundled frontend assets. The binary is cached at `~/.cache/claude-view/` so subsequent runs start instantly.
+---
 
 ## Links
 
-- [GitHub Repository](https://github.com/tombelieber/claude-view)
+- [Website](https://claudeview.ai) — docs, changelog, blog
+- [GitHub Repository](https://github.com/tombelieber/claude-view) — full feature list, comparison table, architecture details
+- [@claude-view/plugin](https://www.npmjs.com/package/@claude-view/plugin) — Claude Code plugin with 8 MCP tools and 3 skills
+- [claude-backup](https://github.com/tombelieber/claude-backup) — Claude Code deletes your sessions after 30 days. This saves them.
 - [Report an Issue](https://github.com/tombelieber/claude-view/issues)
+- [Discord](https://discord.gg/G7wdZTpRfu)
 
-## License
+---
+
+<div align="center">
 
 MIT
+
+</div>

package/index.js

@@ -1,43 +1,43 @@
 #!/usr/bin/env node
 
-const { execFileSync, spawn } = require("child_process");
-const fs = require("fs");
-const path = require("path");
-const os = require("os");
-const https = require("https");
-const zlib = require("zlib");
+const { execFileSync, execSync, spawn } = require('child_process')
+const fs = require('fs')
+const path = require('path')
+const os = require('os')
+const https = require('https')
+const zlib = require('zlib')
 
-const VERSION = require("./package.json").version;
-const REPO = "tombelieber/claude-view";
-const BINARY_NAME = process.platform === "win32" ? "claude-view.exe" : "claude-view";
+const VERSION = require('./package.json').version
+const REPO = 'tombelieber/claude-view'
+const BINARY_NAME = process.platform === 'win32' ? 'claude-view.exe' : 'claude-view'
 
 // --- Platform detection ---
 
 const PLATFORM_MAP = {
-  "darwin-arm64": { artifact: "claude-view-darwin-arm64.tar.gz", ext: "tar.gz" },
-  "darwin-x64": { artifact: "claude-view-darwin-x64.tar.gz", ext: "tar.gz" },
-  "linux-x64": { artifact: "claude-view-linux-x64.tar.gz", ext: "tar.gz" },
-  "win32-x64": { artifact: "claude-view-win32-x64.zip", ext: "zip" },
-};
+  'darwin-arm64': { artifact: 'claude-view-darwin-arm64.tar.gz', ext: 'tar.gz' },
+  'darwin-x64': { artifact: 'claude-view-darwin-x64.tar.gz', ext: 'tar.gz' },
+  'linux-x64': { artifact: 'claude-view-linux-x64.tar.gz', ext: 'tar.gz' },
+  'win32-x64': { artifact: 'claude-view-win32-x64.zip', ext: 'zip' },
+}
 
-const platformKey = `${process.platform}-${process.arch}`;
-const platformInfo = PLATFORM_MAP[platformKey];
+const platformKey = `${process.platform}-${process.arch}`
+const platformInfo = PLATFORM_MAP[platformKey]
 
 if (!platformInfo) {
   console.error(
     `Error: Unsupported platform "${process.platform}" with architecture "${process.arch}".\n` +
-      `Supported: macOS (arm64, x64), Linux (x64), Windows (x64).`
-  );
-  process.exit(1);
+      `Supported: macOS (arm64, x64), Linux (x64), Windows (x64).`,
+  )
+  process.exit(1)
 }
 
 // --- Cache paths ---
 
-const cacheDir = path.join(os.homedir(), ".cache", "claude-view");
-const binDir = path.join(cacheDir, "bin");
-const versionFile = path.join(cacheDir, "version");
-const binaryPath = path.join(binDir, BINARY_NAME);
-const distDir = path.join(binDir, "dist");
+const cacheDir = path.join(os.homedir(), '.cache', 'claude-view')
+const binDir = path.join(cacheDir, 'bin')
+const versionFile = path.join(cacheDir, 'version')
+const binaryPath = path.join(binDir, BINARY_NAME)
+const distDir = path.join(binDir, 'dist')
 
 // --- Helpers ---
 
@@ -46,80 +46,80 @@ function download(url) {
     const request = https.get(url, (res) => {
       // Follow redirects (GitHub releases redirect to S3/CDN)
       if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-        return download(res.headers.location).then(resolve, reject);
+        return download(res.headers.location).then(resolve, reject)
       }
       if (res.statusCode !== 200) {
-        reject(new Error(`Download failed: HTTP ${res.statusCode} from ${url}`));
-        res.resume();
-        return;
+        reject(new Error(`Download failed: HTTP ${res.statusCode} from ${url}`))
+        res.resume()
+        return
       }
-      const chunks = [];
-      res.on("data", (chunk) => chunks.push(chunk));
-      res.on("end", () => resolve(Buffer.concat(chunks)));
-      res.on("error", reject);
-    });
-    request.on("error", reject);
-  });
+      const chunks = []
+      res.on('data', (chunk) => chunks.push(chunk))
+      res.on('end', () => resolve(Buffer.concat(chunks)))
+      res.on('error', reject)
+    })
+    request.on('error', reject)
+  })
 }
 
 function extractTarGz(buffer, destDir) {
   // Use system tar — available on macOS, Linux, and modern Windows (tar ships with Win10+)
-  fs.mkdirSync(destDir, { recursive: true });
-  const tmpFile = path.join(os.tmpdir(), `claude-view-${Date.now()}.tar.gz`);
-  fs.writeFileSync(tmpFile, buffer);
+  fs.mkdirSync(destDir, { recursive: true })
+  const tmpFile = path.join(os.tmpdir(), `claude-view-${Date.now()}.tar.gz`)
+  fs.writeFileSync(tmpFile, buffer)
   try {
-    execFileSync("tar", ["xzf", tmpFile, "-C", destDir], { stdio: "pipe" });
+    execFileSync('tar', ['xzf', tmpFile, '-C', destDir], { stdio: 'pipe' })
   } finally {
-    fs.unlinkSync(tmpFile);
+    fs.unlinkSync(tmpFile)
   }
 }
 
 function extractZip(buffer, destDir) {
   // Use system tar on Windows 10+ (supports zip) or PowerShell as fallback
-  fs.mkdirSync(destDir, { recursive: true });
-  const tmpFile = path.join(os.tmpdir(), `claude-view-${Date.now()}.zip`);
-  fs.writeFileSync(tmpFile, buffer);
+  fs.mkdirSync(destDir, { recursive: true })
+  const tmpFile = path.join(os.tmpdir(), `claude-view-${Date.now()}.zip`)
+  fs.writeFileSync(tmpFile, buffer)
   try {
-    if (process.platform === "win32") {
+    if (process.platform === 'win32') {
       execFileSync(
-        "powershell",
-        ["-Command", `Expand-Archive -Force -Path '${tmpFile}' -DestinationPath '${destDir}'`],
-        { stdio: "pipe" }
-      );
+        'powershell',
+        ['-Command', `Expand-Archive -Force -Path '${tmpFile}' -DestinationPath '${destDir}'`],
+        { stdio: 'pipe' },
+      )
     } else {
-      execFileSync("unzip", ["-o", tmpFile, "-d", destDir], { stdio: "pipe" });
+      execFileSync('unzip', ['-o', tmpFile, '-d', destDir], { stdio: 'pipe' })
     }
   } finally {
-    fs.unlinkSync(tmpFile);
+    fs.unlinkSync(tmpFile)
   }
 }
 
 function downloadChecksums(version) {
-  const url = `https://github.com/${REPO}/releases/download/v${version}/checksums.txt`;
+  const url = `https://github.com/${REPO}/releases/download/v${version}/checksums.txt`
   return download(url)
     .then((buf) => {
-      const map = {};
-      const lines = buf.toString("utf-8").split("\n");
+      const map = {}
+      const lines = buf.toString('utf-8').split('\n')
       for (const line of lines) {
         // Format: "<64-hex-chars>  <filename>" (two spaces between hash and filename)
-        const match = line.match(/^([0-9a-f]{64})  (.+)$/);
+        const match = line.match(/^([0-9a-f]{64}) {2}(.+)$/)
         if (match) {
-          map[match[2]] = match[1];
+          map[match[2]] = match[1]
         }
       }
-      return map;
+      return map
     })
-    .catch(() => null); // Graceful fallback for older releases without checksums
+    .catch(() => null) // Graceful fallback for older releases without checksums
 }
 
 function verifyChecksum(buffer, expectedHash) {
-  const crypto = require("crypto");
-  const actualHash = crypto.createHash("sha256").update(buffer).digest("hex");
+  const crypto = require('crypto')
+  const actualHash = crypto.createHash('sha256').update(buffer).digest('hex')
   if (actualHash !== expectedHash) {
-    console.error(`Checksum verification failed.`);
-    console.error(`  Expected: ${expectedHash}`);
-    console.error(`  Actual:   ${actualHash}`);
-    process.exit(1);
+    console.error(`Checksum verification failed.`)
+    console.error(`  Expected: ${expectedHash}`)
+    console.error(`  Actual:   ${actualHash}`)
+    process.exit(1)
   }
 }
 
@@ -127,81 +127,95 @@ function verifyChecksum(buffer, expectedHash) {
 
 async function main() {
   // Check if cached version matches
-  let needsDownload = true;
+  let needsDownload = true
   if (fs.existsSync(versionFile) && fs.existsSync(binaryPath)) {
-    const cached = fs.readFileSync(versionFile, "utf-8").trim();
+    const cached = fs.readFileSync(versionFile, 'utf-8').trim()
     if (cached === VERSION) {
-      needsDownload = false;
+      needsDownload = false
     }
   }
 
   if (needsDownload) {
-    const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${platformInfo.artifact}`;
-    console.log(`Downloading claude-view v${VERSION} for ${platformKey}...`);
+    const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${platformInfo.artifact}`
+    console.log(`Downloading claude-view v${VERSION} for ${platformKey}...`)
 
-    let buffer;
+    let buffer
     try {
-      buffer = await download(url);
+      buffer = await download(url)
     } catch (err) {
-      console.error(`\nFailed to download claude-view:\n  ${err.message}`);
-      console.error(`\nURL: ${url}`);
-      console.error(`\nCheck that release v${VERSION} exists at https://github.com/${REPO}/releases`);
-      process.exit(1);
+      console.error(`\nFailed to download claude-view:\n  ${err.message}`)
+      console.error(`\nURL: ${url}`)
+      console.error(
+        `\nCheck that release v${VERSION} exists at https://github.com/${REPO}/releases`,
+      )
+      process.exit(1)
     }
 
     // Verify checksum if available
-    const checksums = await downloadChecksums(VERSION);
+    const checksums = await downloadChecksums(VERSION)
     if (checksums && checksums[platformInfo.artifact]) {
-      verifyChecksum(buffer, checksums[platformInfo.artifact]);
-      console.log("Checksum verified.");
+      verifyChecksum(buffer, checksums[platformInfo.artifact])
+      console.log('Checksum verified.')
     }
 
     // Clean previous install
-    fs.rmSync(binDir, { recursive: true, force: true });
-    fs.mkdirSync(binDir, { recursive: true });
+    fs.rmSync(binDir, { recursive: true, force: true })
+    fs.mkdirSync(binDir, { recursive: true })
 
     // Extract
     try {
-      if (platformInfo.ext === "zip") {
-        extractZip(buffer, binDir);
+      if (platformInfo.ext === 'zip') {
+        extractZip(buffer, binDir)
       } else {
-        extractTarGz(buffer, binDir);
+        extractTarGz(buffer, binDir)
       }
     } catch (err) {
-      console.error(`\nFailed to extract archive:\n  ${err.message}`);
-      process.exit(1);
+      console.error(`\nFailed to extract archive:\n  ${err.message}`)
+      process.exit(1)
     }
 
     // Make binary executable (no-op on Windows)
-    if (process.platform !== "win32") {
-      fs.chmodSync(binaryPath, 0o755);
+    if (process.platform !== 'win32') {
+      fs.chmodSync(binaryPath, 0o755)
     }
 
     // macOS Gatekeeper: remove quarantine flag from downloaded binary
-    if (process.platform === "darwin") {
+    if (process.platform === 'darwin') {
       try {
-        execFileSync("xattr", ["-dr", "com.apple.quarantine", binDir], { stdio: "pipe" });
+        execFileSync('xattr', ['-dr', 'com.apple.quarantine', binDir], { stdio: 'pipe' })
       } catch {
         // Ignore — xattr may not be available or quarantine flag may not be set
       }
     }
 
     // Write version marker
-    fs.mkdirSync(cacheDir, { recursive: true });
-    fs.writeFileSync(versionFile, VERSION);
+    fs.mkdirSync(cacheDir, { recursive: true })
+    fs.writeFileSync(versionFile, VERSION)
 
-    console.log(`Installed to ${binDir}`);
+    console.log(`Installed to ${binDir}`)
   }
 
   // Verify binary exists
   if (!fs.existsSync(binaryPath)) {
-    console.error(`Error: Binary not found at ${binaryPath}`);
-    console.error("Try deleting ~/.cache/claude-view/ and running again.");
-    process.exit(1);
+    console.error(`Error: Binary not found at ${binaryPath}`)
+    console.error('Try deleting ~/.cache/claude-view/ and running again.')
+    process.exit(1)
   }
 
   // Set STATIC_DIR so the server finds the frontend assets
-  const env = { ...process.env, STATIC_DIR: distDir };
+  const env = { ...process.env, STATIC_DIR: distDir }
+
+  // Set SIDECAR_DIR so the server can spawn the Agent SDK sidecar
+  const sidecarDir = path.join(binDir, 'sidecar')
+  if (fs.existsSync(sidecarDir)) {
+    // Install sidecar deps if needed (first run after download)
+    const nodeModules = path.join(sidecarDir, 'node_modules')
+    if (!fs.existsSync(nodeModules)) {
+      console.log('Installing sidecar dependencies...')
+      execSync('npm install --omit=dev', { cwd: sidecarDir, stdio: 'inherit' })
+    }
+    env.SIDECAR_DIR = sidecarDir
+  }
 
   // Run the server, forwarding signals and exit code.
   //
@@ -211,29 +225,29 @@ async function main() {
   //   the Rust server's graceful shutdown to see two SIGINTs from one Ctrl+C.
   // - SIGTERM/SIGHUP: Forward. These may be sent to our PID only (e.g. from
   //   `kill` or a process manager), so the child wouldn't get them otherwise.
-  const child = spawn(binaryPath, process.argv.slice(2), { stdio: "inherit", env });
+  const child = spawn(binaryPath, process.argv.slice(2), { stdio: 'inherit', env })
 
   // Prevent Node from exiting on SIGINT before the child does.
-  const ignoreSigint = () => {};
-  process.on("SIGINT", ignoreSigint);
+  const ignoreSigint = () => {}
+  process.on('SIGINT', ignoreSigint)
 
   // Forward SIGTERM/SIGHUP — child may not receive these from process group.
-  for (const sig of ["SIGTERM", "SIGHUP"]) {
-    process.on(sig, () => child.kill(sig));
+  for (const sig of ['SIGTERM', 'SIGHUP']) {
+    process.on(sig, () => child.kill(sig))
   }
 
-  child.on("exit", (code, signal) => {
+  child.on('exit', (code, signal) => {
     // Remove our SIGINT handler so the re-signal below uses default behavior.
-    process.removeListener("SIGINT", ignoreSigint);
+    process.removeListener('SIGINT', ignoreSigint)
 
     if (signal) {
       // Child was killed by signal — re-signal ourselves so the parent shell
       // sees the correct exit status (128 + signal number).
-      process.kill(process.pid, signal);
+      process.kill(process.pid, signal)
     } else {
-      process.exit(code ?? 1);
+      process.exit(code ?? 1)
     }
-  });
+  })
 }
 
-main();
+main()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-view",
-  "version": "0.8.0",
-  "description": "Browse and search your Claude Code sessions in a beautiful local web UI",
+  "version": "0.11.0",
+  "description": "You have 10 Claude sessions running. What are they doing? Live dashboard for Claude Code — monitor every session, track costs, search history, see sub-agents. One command: npx claude-view",
   "bin": {
     "claude-view": "./index.js"
   },
@@ -10,18 +10,53 @@
     "type": "git",
     "url": "https://github.com/tombelieber/claude-view"
   },
+  "homepage": "https://claudeview.ai",
+  "bugs": {
+    "url": "https://github.com/tombelieber/claude-view/issues"
+  },
   "keywords": [
     "claude",
     "claude-code",
-    "sessions",
-    "viewer",
-    "browser"
+    "anthropic",
+    "ai",
+    "ai-agents",
+    "mcp",
+    "dashboard",
+    "monitoring",
+    "mission-control",
+    "developer-tools",
+    "cli",
+    "session",
+    "session-history",
+    "session-viewer",
+    "session-monitor",
+    "full-text-search",
+    "search",
+    "tantivy",
+    "cost-tracking",
+    "analytics",
+    "metrics",
+    "heatmap",
+    "activity-log",
+    "reports",
+    "fluency-score",
+    "sub-agents",
+    "subagents",
+    "agent-monitor",
+    "context-window",
+    "cache-countdown",
+    "real-time",
+    "sse",
+    "websocket",
+    "conversation-viewer",
+    "export",
+    "rust",
+    "react",
+    "axum",
+    "sqlite"
   ],
   "engines": {
     "node": ">=16"
   },
-  "files": [
-    "index.js",
-    "README.md"
-  ]
+  "files": ["index.js", "README.md"]
 }