claude-mux 0.7.0

package/README.md

@@ -0,0 +1,366 @@
+<p align="center">
+  <h1 align="center">claude-mux</h1>
+  <p align="center">
+    <strong>A real-time web dashboard for monitoring and controlling multiple Claude Code sessions</strong>
+  </p>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/claude-mux"><img src="https://img.shields.io/npm/v/claude-mux?style=flat-square&color=blue" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/claude-mux"><img src="https://img.shields.io/npm/dm/claude-mux?style=flat-square&color=green" alt="npm downloads"></a>
+  <a href="https://github.com/christinoleo/claude-mux/blob/main/LICENSE"><img src="https://img.shields.io/github/license/christinoleo/claude-mux?style=flat-square" alt="license"></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square" alt="node version">
+  <img src="https://img.shields.io/badge/platform-linux%20%7C%20macos-lightgrey?style=flat-square" alt="platform">
+</p>
+
+<p align="center">
+  <a href="#features">Features</a> •
+  <a href="#installation">Installation</a> •
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#web-interface">Web Interface</a> •
+  <a href="#how-it-works">How It Works</a>
+</p>
+
+---
+
+## Screenshots
+
+<p align="center">
+  <img src="docs/images/desktop-dashboard.png" alt="Desktop Dashboard" width="100%">
+  <br>
+  <em>Dashboard view — Monitor all your Claude Code sessions at a glance</em>
+</p>
+
+<p align="center">
+  <img src="docs/images/desktop-session.png" alt="Session View with Syntax Highlighting" width="100%">
+  <br>
+  <em>Session view — Real-time terminal output with syntax highlighting</em>
+</p>
+
+<details>
+<summary><strong>Mobile Screenshots</strong></summary>
+<br>
+<p align="center">
+  <img src="docs/images/mobile-dashboard.png" alt="Mobile Dashboard" width="300">
+  &nbsp;&nbsp;&nbsp;
+  <img src="docs/images/mobile-session.png" alt="Mobile Session" width="300">
+</p>
+<p align="center"><em>Fully responsive — Control your Claude sessions from your phone</em></p>
+</details>
+
+---
+
+## Features
+
+### Web Dashboard
+- **Real-time monitoring** of all Claude Code sessions via WebSocket
+- **Project-based organization** — Sessions grouped by working directory
+- **Live status indicators** — See which sessions are busy, idle, or waiting for input
+- **One-click navigation** — Jump to any session instantly
+
+### Syntax Highlighting
+- **Color-coded terminal output** — User prompts, Claude responses, tool calls, and results
+- **Tool-specific colors** — Different colors for Read, Write, Edit, Bash, Task, and more
+- **Diff highlighting** — Green for additions, red for removals in file edits
+- **Toggleable theming** — Switch between styled and raw output
+
+### Mobile-First Design
+- **Fully responsive** — Works on desktop, tablet, and phone
+- **Touch-friendly controls** — Large buttons for common actions
+- **Quick action toolbar** — Send keys (Up, Down, Tab, Esc, Ctrl-C) with one tap
+
+### Session Control
+- **Send text input** — Type messages directly to Claude
+- **Keyboard shortcuts** — Send special keys and key combinations
+- **Terminal resize** — Fit tmux pane to browser viewport
+- **Kill sessions** — Terminate Claude processes when needed
+
+### Optional Features
+- **Authentication** — Password-protect your dashboard
+- **LAN access** — Monitor sessions from any device on your network
+
+---
+
+## Installation
+
+### From npm/bun (recommended)
+
+```bash
+bun install -g claude-mux
+# or: npm install -g claude-mux
+```
+
+### From source
+
+```bash
+git clone https://github.com/christinoleo/claude-mux.git
+cd claude-mux
+bun install
+bun run build
+bun link  # Makes 'claude-mux' available globally
+```
+
+---
+
+## Quick Start
+
+### 1. Run setup
+
+```bash
+claude-mux setup
+```
+
+This will:
+- Create the data directory at `~/.claude-watch/`
+- Install Claude Code hooks in `~/.claude/settings.json`
+
+### 2. Start the web server
+
+```bash
+claude-mux serve --port 3456 --host 0.0.0.0
+```
+
+### 3. Open the dashboard
+
+Navigate to `http://localhost:3456` (or your machine's IP for LAN access).
+
+### 4. Start using Claude Code
+
+Any Claude Code session started after setup will appear in the dashboard automatically.
+
+---
+
+## Web Interface
+
+### Dashboard
+
+The main dashboard shows all active Claude Code sessions organized by project:
+
+| Element | Description |
+|---------|-------------|
+| **Project cards** | Sessions grouped by working directory |
+| **Status indicators** | Busy, Idle, Waiting for input |
+| **Current action** | Shows what Claude is currently doing |
+| **Quick actions** | New session, kill session, refresh |
+
+### Session View
+
+Click any session to open the real-time terminal view:
+
+| Feature | Description |
+|---------|-------------|
+| **Live output** | Streams terminal content via WebSocket |
+| **Syntax highlighting** | Color-coded messages and tool calls |
+| **Text input** | Send messages to Claude |
+| **Action buttons** | Up, Down, Space, Tab, Esc, Ctrl-C, etc. |
+| **Tmux command** | Copy `tmux attach` command for direct access |
+
+### Keyboard Shortcuts (in session view)
+
+| Key | Action |
+|-----|--------|
+| `Enter` | Send message |
+| `Shift+Enter` | New line in message |
+
+---
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `claude-mux serve` | Start the web server |
+| `claude-mux setup` | Run interactive setup wizard |
+| `claude-mux uninstall` | Remove hooks and configuration |
+| `claude-mux` | Start TUI dashboard (legacy, requires tmux) |
+
+### Server Options
+
+```bash
+claude-mux serve [options]
+
+Options:
+  -p, --port <number>     Port to listen on (default: 45677)
+  -h, --host <string>     Host to bind to (default: "localhost")
+  -a, --auth <password>   Enable authentication with password
+```
+
+### Examples
+
+```bash
+# Start on custom port
+claude-mux serve --port 8080
+
+# Allow LAN access
+claude-mux serve --host 0.0.0.0
+
+# With authentication
+claude-mux serve --host 0.0.0.0 --auth mysecretpassword
+```
+
+---
+
+## How It Works
+
+### Architecture
+
+```
+┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
+│  Claude Code    │────▶│  Hook Scripts    │────▶│  JSON Files     │
+│  (running)      │     │  (on events)     │     │  (~/.claude-watch/sessions/)
+└─────────────────┘     └──────────────────┘     └────────┬────────┘
+                                                          │
+┌─────────────────┐     ┌──────────────────┐              │
+│  tmux panes     │────▶│  Pane Capture    │──────────────┤
+│  (terminal)     │     │  (WebSocket)     │              │
+└─────────────────┘     └──────────────────┘              │
+                                                          ▼
+                        ┌──────────────────┐     ┌─────────────────┐
+                        │  Web Browser     │◀───▶│  SvelteKit      │
+                        │  (dashboard)     │     │  (WebSocket)    │
+                        └──────────────────┘     └─────────────────┘
+```
+
+### Claude Code Hooks
+
+claude-mux uses [Claude Code hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) to track session state:
+
+| Hook | Purpose |
+|------|---------|
+| `SessionStart` | Register new session with PID and working directory |
+| `UserPromptSubmit` | Mark session as busy |
+| `PreToolUse` | Update status with current tool name |
+| `Stop` | Mark session as idle when turn ends |
+| `Notification` | Handle permission requests and questions |
+
+### Real-time Updates
+
+- **WebSocket connections** for instant updates (no polling)
+- **File watcher** monitors session state changes
+- **Pane capture** streams terminal output every 200ms
+
+---
+
+## Terminal UI (Legacy)
+
+claude-mux also includes a terminal-based dashboard for use inside tmux:
+
+```bash
+claude-mux  # Requires tmux
+```
+
+| Key | Action |
+|-----|--------|
+| `j` / `↓` | Move selection down |
+| `k` / `↑` | Move selection up |
+| `Enter` | Jump to selected session |
+| `q` | Quit dashboard |
+
+Press `prefix + W` from any tmux session to jump to the dashboard.
+
+---
+
+## Development
+
+### Prerequisites
+
+- Node.js >= 18 (or Bun)
+- tmux (for full functionality)
+
+### Setup
+
+```bash
+git clone https://github.com/christinoleo/claude-mux.git
+cd claude-mux
+bun install
+```
+
+### Development Server
+
+```bash
+bun run dev:serve  # Starts Vite dev server with HMR
+```
+
+### Build
+
+```bash
+bun run build      # Build CLI + web app
+bun run build:cli  # Build CLI only
+bun run build:web  # Build web app only
+```
+
+### Testing
+
+```bash
+bun test           # Run tests
+bun run lint       # Lint code
+bun run format     # Format code
+```
+
+### Project Structure
+
+```
+claude-mux/
+├── src/                    # CLI and hooks
+│   ├── cli.ts              # Entry point
+│   ├── commands/           # CLI commands (serve, setup, tui)
+│   ├── hooks/              # Claude Code hook handler
+│   └── server/             # File watcher, WebSocket handlers
+├── web/                    # SvelteKit web app
+│   ├── src/
+│   │   ├── lib/
+│   │   │   ├── components/ # UI components
+│   │   │   ├── stores/     # Svelte stores (sessions, terminal, preferences)
+│   │   │   └── utils/      # Terminal parser, helpers
+│   │   └── routes/         # Pages and API routes
+│   └── svelte.config.js
+└── docs/
+    └── images/             # Screenshots
+```
+
+---
+
+## Troubleshooting
+
+### Sessions not appearing
+
+1. Ensure you ran `claude-mux setup` to install hooks
+2. Restart any running Claude Code sessions (hooks are loaded at startup)
+3. Check that `~/.claude/settings.json` contains claude-mux hooks
+
+### Cannot connect from another device
+
+1. Use `--host 0.0.0.0` to allow external connections
+2. Check your firewall allows the port
+3. Use your machine's LAN IP, not `localhost`
+
+### Status not updating
+
+1. Check hooks are installed: `grep claude-mux ~/.claude/settings.json`
+2. Restart Claude Code sessions to pick up new hooks
+
+---
+
+## Requirements
+
+- **Node.js** >= 18 (or Bun)
+- **tmux** (required for terminal capture)
+- **Claude Code** with hooks support
+
+---
+
+## License
+
+MIT
+
+---
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Run tests (`bun test`)
+4. Commit your changes
+5. Push to the branch
+6. Open a Pull Request

package/dist/app.d.ts

@@ -0,0 +1,2 @@
+export declare function App(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"AAkBA,wBAAgB,GAAG,4CAyKlB"}

package/dist/app.js

@@ -0,0 +1,147 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect, useCallback } from "react";
+import { Box, useApp, useInput, useStdout } from "ink";
+import { Header, HelpDialog, SessionList, StatusBar } from "./components/index.js";
+import { getTotalItemCount, getItemAtIndex } from "./components/SessionList.js";
+import { getAllSessions, cleanupStaleSessions, updateSession, } from "./db/index.js";
+import { isInTmux, getAllTmuxSessions, getTmuxSessionName } from "./tmux/detect.js";
+import { switchToTarget } from "./tmux/navigate.js";
+import { checkForInterruption } from "./tmux/pane.js";
+const POLL_INTERVAL = 500; // ms
+const CLEANUP_INTERVAL = 5000; // ms
+const PANE_CHECK_INTERVAL = 500; // ms - check tmux panes for prompt
+export function App() {
+    const { exit } = useApp();
+    const { stdout } = useStdout();
+    const [sessions, setSessions] = useState([]);
+    const [tmuxSessions, setTmuxSessions] = useState([]);
+    const [selectedIndex, setSelectedIndex] = useState(0);
+    const [showHelp, setShowHelp] = useState(false);
+    const [inTmux] = useState(() => isInTmux());
+    const [currentTmuxSession] = useState(() => getTmuxSessionName());
+    // Get terminal dimensions
+    const terminalHeight = stdout?.rows || 24;
+    const terminalWidth = stdout?.columns || 80;
+    // Load sessions from JSON files and tmux
+    const loadSessions = useCallback(() => {
+        try {
+            const loadedSessions = getAllSessions();
+            // Only update if sessions have changed (compare by JSON to detect actual changes)
+            setSessions((prev) => {
+                const prevJson = JSON.stringify(prev);
+                const newJson = JSON.stringify(loadedSessions);
+                return prevJson === newJson ? prev : loadedSessions;
+            });
+            // Also load tmux sessions (excluding the current session where claude-mux runs)
+            const loadedTmuxSessions = getAllTmuxSessions().filter((ts) => ts.name !== currentTmuxSession);
+            // Only update if tmux sessions have changed
+            setTmuxSessions((prev) => {
+                const prevJson = JSON.stringify(prev);
+                const newJson = JSON.stringify(loadedTmuxSessions);
+                return prevJson === newJson ? prev : loadedTmuxSessions;
+            });
+            // Adjust selected index if out of bounds
+            const totalCount = getTotalItemCount(loadedSessions, loadedTmuxSessions);
+            if (selectedIndex >= totalCount) {
+                setSelectedIndex(Math.max(0, totalCount - 1));
+            }
+        }
+        catch {
+            // Ignore errors, try again next poll
+        }
+    }, [selectedIndex, currentTmuxSession]);
+    // Poll for session updates
+    useEffect(() => {
+        loadSessions();
+        const interval = setInterval(loadSessions, POLL_INTERVAL);
+        return () => clearInterval(interval);
+    }, [loadSessions]);
+    // Cleanup stale sessions periodically
+    useEffect(() => {
+        const cleanup = () => {
+            try {
+                cleanupStaleSessions();
+            }
+            catch {
+                // Ignore errors during cleanup
+            }
+        };
+        cleanup(); // Run on startup
+        const interval = setInterval(cleanup, CLEANUP_INTERVAL);
+        return () => clearInterval(interval);
+    }, []);
+    // Check tmux panes to sync state with what's actually shown
+    useEffect(() => {
+        if (!inTmux)
+            return;
+        const checkPanes = () => {
+            try {
+                const allSessions = getAllSessions().filter((s) => s.tmux_target);
+                for (const session of allSessions) {
+                    if (!session.tmux_target)
+                        continue;
+                    const update = checkForInterruption(session.tmux_target);
+                    if (update && session.state !== "idle") {
+                        updateSession(session.id, update);
+                    }
+                }
+            }
+            catch {
+                // Ignore errors during pane check
+            }
+        };
+        const interval = setInterval(checkPanes, PANE_CHECK_INTERVAL);
+        return () => clearInterval(interval);
+    }, [inTmux]);
+    // Get total item count for navigation
+    const totalCount = getTotalItemCount(sessions, tmuxSessions);
+    // Calculate non-Claude tmux session count for header
+    const claudeTmuxSessions = new Set();
+    for (const session of sessions) {
+        if (session.tmux_target) {
+            const sessionName = session.tmux_target.split(":")[0];
+            claudeTmuxSessions.add(sessionName);
+        }
+    }
+    const nonClaudeTmuxCount = tmuxSessions.filter((ts) => !claudeTmuxSessions.has(ts.name)).length;
+    // Handle keyboard input
+    useInput((input, key) => {
+        if (input === "q") {
+            exit();
+            return;
+        }
+        if (input === "h") {
+            setShowHelp((prev) => !prev);
+            return;
+        }
+        // Dismiss help on any other key
+        if (showHelp) {
+            setShowHelp(false);
+            return;
+        }
+        if (totalCount === 0)
+            return;
+        // Navigation
+        if (key.upArrow || input === "k") {
+            setSelectedIndex((prev) => Math.max(0, prev - 1));
+        }
+        else if (key.downArrow || input === "j") {
+            setSelectedIndex((prev) => Math.min(totalCount - 1, prev + 1));
+        }
+        // Jump to session
+        if (key.return && inTmux) {
+            const item = getItemAtIndex(sessions, tmuxSessions, selectedIndex);
+            if (item) {
+                if (item.type === "claude" && item.session.tmux_target) {
+                    switchToTarget(item.session.tmux_target);
+                }
+                else if (item.type === "tmux") {
+                    // For tmux sessions, switch to the session (first window)
+                    switchToTarget(item.tmuxSession.name + ":");
+                }
+            }
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", height: terminalHeight, children: [_jsx(Header, { claudeCount: sessions.length, tmuxCount: nonClaudeTmuxCount }), _jsx(Box, { borderStyle: "single", borderTop: false, borderBottom: false, flexGrow: 1, children: showHelp ? (_jsx(HelpDialog, { width: terminalWidth - 2 })) : (_jsx(SessionList, { sessions: sessions, tmuxSessions: tmuxSessions, selectedIndex: selectedIndex, width: terminalWidth - 2 })) }), _jsx(StatusBar, { inTmux: inTmux })] }));
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.tsx"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import { program } from "commander";
+import { createServeCommand, createSetupCommand, createUninstallCommand, runTui, runServe, } from "./commands/index.js";
+import { runSetup, runCleanup } from "./setup/index.js";
+import { DEFAULT_SERVER_PORT } from "./utils/paths.js";
+import { VERSION } from "./utils/version.js";
+// Deprecation warning helper
+function deprecationWarning(oldFlag, newCommand) {
+    console.warn(`\x1b[33m⚠ Warning: --${oldFlag} is deprecated. Use "claude-mux ${newCommand}" instead.\x1b[0m`);
+    console.warn("");
+}
+program
+    .name("claude-mux")
+    .description("TUI dashboard for monitoring Claude Code sessions")
+    .version(VERSION);
+// Register subcommands
+program.addCommand(createServeCommand());
+program.addCommand(createSetupCommand());
+program.addCommand(createUninstallCommand());
+// BACKWARD COMPATIBILITY: Support old flags on root command
+program
+    .option("--setup", "Run interactive setup wizard (deprecated: use 'setup' command)")
+    .option("--uninstall", "Remove hooks (deprecated: use 'uninstall' command)")
+    .option("--cleanup", "Remove hooks (alias for --uninstall)")
+    .option("--serve", "Start HTTP server alongside TUI (use with --serve-port, --serve-host)")
+    .option("--serve-only", "Run HTTP server only (deprecated: use 'serve' command)")
+    .option("--serve-port <number>", "Server port for --serve/--serve-only", String(DEFAULT_SERVER_PORT))
+    .option("--serve-host <address>", "Server host for --serve/--serve-only", "127.0.0.1");
+// Hide deprecated options from help
+program.options.forEach((opt) => {
+    if (["--setup", "--uninstall", "--cleanup", "--serve-only", "--serve-port", "--serve-host"].includes(opt.long || "")) {
+        opt.hidden = true;
+    }
+});
+// Default action: handle deprecated flags or run TUI
+program.action(async (options) => {
+    // Handle deprecated --setup flag
+    if (options.setup) {
+        deprecationWarning("setup", "setup");
+        await runSetup();
+        process.exit(0);
+    }
+    // Handle deprecated --uninstall or --cleanup flag
+    if (options.uninstall || options.cleanup) {
+        if (options.uninstall) {
+            deprecationWarning("uninstall", "uninstall");
+        }
+        await runCleanup();
+        process.exit(0);
+    }
+    // Handle deprecated --serve-only flag
+    if (options.serveOnly) {
+        deprecationWarning("serve-only", "serve");
+        await runServe({ port: options.servePort, host: options.serveHost });
+        return;
+    }
+    // Default: run TUI (with optional --serve)
+    await runTui({
+        serve: options.serve,
+        port: options.servePort,
+        host: options.serveHost,
+    });
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/index.d.ts

@@ -0,0 +1,5 @@
+export { createTuiCommand, runTui } from "./tui.js";
+export { createServeCommand, runServe } from "./serve.js";
+export { createSetupCommand } from "./setup.js";
+export { createUninstallCommand } from "./uninstall.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/commands/index.js

@@ -0,0 +1,5 @@
+export { createTuiCommand, runTui } from "./tui.js";
+export { createServeCommand, runServe } from "./serve.js";
+export { createSetupCommand } from "./setup.js";
+export { createUninstallCommand } from "./uninstall.js";
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/commands/serve.d.ts

@@ -0,0 +1,8 @@
+import { Command } from "commander";
+export interface ServeOptions {
+    port: string;
+    host: string;
+}
+export declare function runServe(options: ServeOptions): Promise<void>;
+export declare function createServeCommand(): Command;
+//# sourceMappingURL=serve.d.ts.map

package/dist/commands/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDnE;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAM5C"}