claude-code-monitor 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-01-17
+
+### Added
+
+- Initial release
+- Real-time monitoring of multiple Claude Code sessions
+- Terminal UI (TUI) with keyboard navigation
+- Focus feature to switch to session's terminal tab
+  - Full support for iTerm2 and Terminal.app (TTY-based targeting)
+  - Limited support for Ghostty (app activation only)
+- Automatic hook setup via `ccm setup`
+- Session status tracking (running, waiting for input, stopped)
+- File-based session state management (no server required)
+- Session auto-cleanup on timeout (30 minutes) or TTY termination
+- Commands: `ccm`, `ccm watch`, `ccm setup`, `ccm list`, `ccm clear`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 onikan27
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,221 @@
+# Claude Code Monitor CLI
+
+[![npm version](https://img.shields.io/npm/v/claude-code-monitor.svg)](https://www.npmjs.com/package/claude-code-monitor)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A CLI tool to monitor multiple Claude Code sessions in real-time from your terminal.
+
+<p align="center">
+  <img src="docs/demo.gif" alt="Claude Code Monitor Demo" width="1000">
+</p>
+
+---
+
+## 📑 Table of Contents
+
+- [✨ Features](#-features)
+- [📋 Requirements](#-requirements)
+- [🚀 Installation](#-installation)
+- [⚡ Quick Start](#-quick-start)
+- [📖 Commands](#-commands)
+- [⌨️ Keybindings](#️-keybindings-watch-mode)
+- [🎨 Status Icons](#-status-icons)
+- [🖥️ Supported Terminals](#️-supported-terminals)
+- [💾 Data Storage](#-data-storage)
+- [📦 Programmatic Usage](#-programmatic-usage)
+- [🔧 Troubleshooting](#-troubleshooting)
+- [🔒 Security](#-security)
+- [⚠️ Disclaimer](#️-disclaimer)
+- [📝 Changelog](#-changelog)
+- [📄 License](#-license)
+
+---
+
+## ✨ Features
+
+- 🔌 **Serverless** - File-based session state management (no API server required)
+- 🔄 **Real-time** - Auto-updates on file changes
+- 🎯 **Tab Focus** - Instantly switch to the terminal tab of a selected session
+- 🎨 **Simple UI** - Displays only status and directory
+- ⚡ **Easy Setup** - One command `ccm` for automatic setup and launch
+
+---
+
+## 📋 Requirements
+
+- **macOS** (focus feature is macOS only)
+- **Node.js** >= 18.0.0
+- **Claude Code** installed
+
+---
+
+## 🚀 Installation
+
+### Global install (Recommended)
+
+```bash
+npm install -g claude-code-monitor
+```
+
+### Run with npx (no install required)
+
+```bash
+npx claude-code-monitor
+```
+
+> **Note**: With npx, you must run `npx claude-code-monitor` each time (the `ccm` shortcut is only available with global install). Global install is recommended since this tool requires hook setup and is designed for continuous use.
+
+---
+
+## ⚡ Quick Start
+
+```bash
+ccm
+```
+
+On first run, it automatically sets up hooks and launches the monitor.
+
+---
+
+## 📖 Commands
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `ccm` | - | Launch monitor TUI (auto-setup if not configured) |
+| `ccm watch` | `ccm w` | Launch monitor TUI |
+| `ccm setup` | - | Configure Claude Code hooks |
+| `ccm list` | `ccm ls` | List sessions |
+| `ccm clear` | - | Clear all sessions |
+| `ccm --version` | `ccm -V` | Show version |
+| `ccm --help` | `ccm -h` | Show help |
+
+---
+
+## ⌨️ Keybindings (watch mode)
+
+| Key | Action |
+|-----|--------|
+| `↑` / `k` | Move up |
+| `↓` / `j` | Move down |
+| `Enter` / `f` | Focus selected session |
+| `1-9` | Quick select & focus by number |
+| `c` | Clear all sessions |
+| `q` / `Esc` | Quit |
+
+---
+
+## 🎨 Status Icons
+
+| Icon | Status | Description |
+|------|--------|-------------|
+| `●` | Running | Claude Code is processing |
+| `◐` | Waiting | Waiting for user input (e.g., permission prompt) |
+| `✓` | Done | Session ended |
+
+---
+
+## 🖥️ Supported Terminals
+
+Focus feature works with the following terminals:
+
+| Terminal | Focus Support | Notes |
+|----------|--------------|-------|
+| iTerm2 | ✅ Full | TTY-based window/tab targeting |
+| Terminal.app | ✅ Full | TTY-based window/tab targeting |
+| Ghostty | ⚠️ Limited | Activates app only (cannot target specific window/tab) |
+
+> **Note**: Other terminals (Alacritty, kitty, Warp, etc.) can use monitoring but focus feature is not supported.
+
+---
+
+## 💾 Data Storage
+
+Session data is stored in `~/.claude-monitor/sessions.json`.
+
+### What is stored
+
+| Field | Description |
+|-------|-------------|
+| `session_id` | Claude Code session identifier |
+| `cwd` | Working directory path |
+| `tty` | Terminal device path (e.g., `/dev/ttys001`) |
+| `status` | Session status (running/waiting_input/stopped) |
+| `updated_at` | Last update timestamp |
+
+Data is automatically removed after 30 minutes of inactivity or when the terminal session ends.
+
+---
+
+## 📦 Programmatic Usage
+
+Can also be used as a library:
+
+```typescript
+import { getSessions, getStatusDisplay } from 'claude-code-monitor';
+
+const sessions = getSessions();
+for (const session of sessions) {
+  const { symbol, label } = getStatusDisplay(session.status);
+  console.log(`${symbol} ${label}: ${session.cwd}`);
+}
+```
+
+---
+
+## 🔧 Troubleshooting
+
+### Sessions not showing
+
+1. Run `ccm setup` to verify hook configuration
+2. Check if `~/.claude/settings.json` contains hook settings
+3. Restart Claude Code
+
+```bash
+# Check configuration
+cat ~/.claude/settings.json | grep ccm
+```
+
+### Focus not working
+
+1. Verify you're using macOS
+2. Verify you're using iTerm2, Terminal.app, or Ghostty
+3. Check System Preferences > Privacy & Security > Accessibility permissions
+
+### Reset session data
+
+```bash
+ccm clear
+# or
+rm ~/.claude-monitor/sessions.json
+```
+
+---
+
+## 🔒 Security
+
+- This tool modifies `~/.claude/settings.json` to register hooks
+- Focus feature uses AppleScript to control terminal applications
+- All data is stored locally; no network requests are made
+
+---
+
+## ⚠️ Disclaimer
+
+This is an unofficial community tool and is not affiliated with, endorsed by, or associated with Anthropic.
+"Claude" and "Claude Code" are trademarks of Anthropic.
+
+---
+
+## 📝 Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md) for a list of changes.
+
+---
+
+## 📄 License
+
+MIT
+
+---
+
+<p align="center">Made with ❤️ for the Claude Code community</p>

package/dist/bin/ccm.d.ts

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

package/dist/bin/ccm.d.ts.map

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

package/dist/bin/ccm.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import { jsx as _jsx } from "react/jsx-runtime";
+import { execFileSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { Command } from 'commander';
+import { render } from 'ink';
+import { Dashboard } from '../components/Dashboard.js';
+import { handleHookEvent } from '../hook/handler.js';
+import { isHooksConfigured, setupHooks } from '../setup/index.js';
+import { clearSessions, getSessions } from '../store/file-store.js';
+import { getStatusDisplay } from '../utils/status.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+const CLEAR_SCREEN = '\x1B[2J\x1B[0f';
+/**
+ * Get TTY from ancestor processes
+ */
+const MAX_ANCESTOR_DEPTH = 5;
+function getTtyFromAncestors() {
+    try {
+        let currentPid = process.ppid;
+        for (let i = 0; i < MAX_ANCESTOR_DEPTH; i++) {
+            const ttyName = execFileSync('ps', ['-o', 'tty=', '-p', String(currentPid)], {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'ignore'],
+            }).trim();
+            const isValidTty = ttyName && ttyName !== '??' && ttyName !== '';
+            if (isValidTty) {
+                return `/dev/${ttyName}`;
+            }
+            const ppid = execFileSync('ps', ['-o', 'ppid=', '-p', String(currentPid)], {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'ignore'],
+            }).trim();
+            if (!ppid)
+                break;
+            currentPid = parseInt(ppid, 10);
+        }
+    }
+    catch {
+        // TTY取得失敗は正常（バックグラウンド実行時など）
+    }
+    return undefined;
+}
+const program = new Command();
+program
+    .name('ccm')
+    .description('Claude Code Monitor - CLI-based session monitoring')
+    .version(pkg.version);
+program
+    .command('watch')
+    .alias('w')
+    .description('Start the monitoring TUI')
+    .action(() => {
+    process.stdout.write(CLEAR_SCREEN);
+    const { waitUntilExit } = render(_jsx(Dashboard, {}));
+    waitUntilExit().catch(console.error);
+});
+program
+    .command('hook <event>')
+    .description('Handle a hook event from Claude Code (internal use)')
+    .action(async (event) => {
+    try {
+        const tty = getTtyFromAncestors();
+        await handleHookEvent(event, tty);
+    }
+    catch (e) {
+        console.error('Hook error:', e);
+        process.exit(1);
+    }
+});
+program
+    .command('list')
+    .alias('ls')
+    .description('List all sessions')
+    .action(() => {
+    const sessions = getSessions();
+    if (sessions.length === 0) {
+        console.log('No active sessions');
+        return;
+    }
+    for (const session of sessions) {
+        const cwd = session.cwd.replace(/^\/Users\/[^/]+/, '~');
+        const { symbol } = getStatusDisplay(session.status);
+        console.log(`${symbol} ${cwd}`);
+    }
+});
+program
+    .command('clear')
+    .description('Clear all sessions')
+    .action(() => {
+    clearSessions();
+    console.log('Sessions cleared');
+});
+program
+    .command('setup')
+    .description('Setup Claude Code hooks for monitoring')
+    .action(async () => {
+    await setupHooks();
+});
+/**
+ * Default action (when launched without arguments)
+ * - Run setup if not configured
+ * - Launch monitor if already configured
+ */
+async function defaultAction() {
+    if (!isHooksConfigured()) {
+        console.log('Initial setup required.\n');
+        await setupHooks();
+        // Verify setup was completed
+        if (!isHooksConfigured()) {
+            // Setup was cancelled
+            return;
+        }
+        console.log('');
+    }
+    // Launch monitor
+    process.stdout.write(CLEAR_SCREEN);
+    const { waitUntilExit } = render(_jsx(Dashboard, {}));
+    await waitUntilExit();
+}
+// Default action when executed without commands
+if (process.argv.length === 2) {
+    defaultAction().catch(console.error);
+}
+else {
+    program.parse();
+}

package/dist/components/Dashboard.d.ts

@@ -0,0 +1,3 @@
+import type React from 'react';
+export declare function Dashboard(): React.ReactElement;
+//# sourceMappingURL=Dashboard.d.ts.map

package/dist/components/Dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dashboard.d.ts","sourceRoot":"","sources":["../../src/components/Dashboard.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B,wBAAgB,SAAS,IAAI,KAAK,CAAC,YAAY,CAoH9C"}

package/dist/components/Dashboard.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text, useApp, useInput } from 'ink';
+import { useMemo, useState } from 'react';
+import { useSessions } from '../hooks/useSessions.js';
+import { clearSessions } from '../store/file-store.js';
+import { focusSession } from '../utils/focus.js';
+import { SessionCard } from './SessionCard.js';
+const QUICK_SELECT_KEYS = ['1', '2', '3', '4', '5', '6', '7', '8', '9'];
+export function Dashboard() {
+    const { sessions, loading, error } = useSessions();
+    const [selectedIndex, setSelectedIndex] = useState(0);
+    const { exit } = useApp();
+    const focusSessionByIndex = (index) => {
+        const session = sessions[index];
+        if (session?.tty) {
+            focusSession(session.tty);
+        }
+    };
+    const handleQuickSelect = (input) => {
+        const index = parseInt(input, 10) - 1;
+        if (index < sessions.length) {
+            setSelectedIndex(index);
+            focusSessionByIndex(index);
+        }
+    };
+    const statusCounts = useMemo(() => sessions.reduce((counts, session) => {
+        counts[session.status]++;
+        return counts;
+    }, { running: 0, waiting_input: 0, stopped: 0 }), [sessions]);
+    useInput((input, key) => {
+        if (input === 'q' || key.escape) {
+            exit();
+            return;
+        }
+        if (key.upArrow || input === 'k') {
+            setSelectedIndex((prev) => Math.max(0, prev - 1));
+            return;
+        }
+        if (key.downArrow || input === 'j') {
+            setSelectedIndex((prev) => Math.min(sessions.length - 1, prev + 1));
+            return;
+        }
+        if (key.return || input === 'f') {
+            focusSessionByIndex(selectedIndex);
+            return;
+        }
+        if (QUICK_SELECT_KEYS.includes(input)) {
+            handleQuickSelect(input);
+            return;
+        }
+        if (input === 'c') {
+            clearSessions();
+            setSelectedIndex(0);
+        }
+    });
+    if (loading) {
+        return _jsx(Text, { dimColor: true, children: "Loading..." });
+    }
+    if (error) {
+        return _jsxs(Text, { color: "red", children: ["Error: ", error.message] });
+    }
+    const { running, waiting_input: waitingInput, stopped } = statusCounts;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "Claude Code Monitor" }), _jsx(Text, { dimColor: true, children: " \u2502 " }), _jsxs(Text, { color: "green", children: ["\u25CF ", running] }), _jsx(Text, { dimColor: true, children: " " }), _jsxs(Text, { color: "yellow", children: ["\u25D0 ", waitingInput] }), _jsx(Text, { dimColor: true, children: " " }), _jsxs(Text, { color: "cyan", children: ["\u2713 ", stopped] })] }), _jsx(Box, { flexDirection: "column", borderStyle: "round", borderColor: "gray", marginTop: 1, paddingX: 1, paddingY: 0, children: sessions.length === 0 ? (_jsx(Box, { paddingY: 1, children: _jsx(Text, { dimColor: true, children: "No active sessions" }) })) : (sessions.map((session, index) => (_jsx(SessionCard, { session: session, index: index, isSelected: index === selectedIndex }, `${session.session_id}:${session.tty || ''}`)))) }), _jsxs(Box, { marginTop: 1, justifyContent: "center", gap: 1, children: [_jsx(Text, { dimColor: true, children: "[\u2191\u2193]Select" }), _jsx(Text, { dimColor: true, children: "[Enter]Focus" }), _jsx(Text, { dimColor: true, children: "[1-9]Quick" }), _jsx(Text, { dimColor: true, children: "[c]Clear" }), _jsx(Text, { dimColor: true, children: "[q]Quit" })] })] }));
+}

package/dist/components/SessionCard.d.ts

@@ -0,0 +1,10 @@
+import type React from 'react';
+import type { Session } from '../types/index.js';
+interface SessionCardProps {
+    session: Session;
+    index: number;
+    isSelected: boolean;
+}
+export declare const SessionCard: React.NamedExoticComponent<SessionCardProps>;
+export {};
+//# sourceMappingURL=SessionCard.d.ts.map

package/dist/components/SessionCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionCard.d.ts","sourceRoot":"","sources":["../../src/components/SessionCard.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAKjD,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAMD,eAAO,MAAM,WAAW,8CAiCtB,CAAC"}

package/dist/components/SessionCard.js

@@ -0,0 +1,16 @@
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import { memo } from 'react';
+import { getStatusDisplay } from '../utils/status.js';
+import { formatRelativeTime } from '../utils/time.js';
+import { Spinner } from './Spinner.js';
+function abbreviateHomePath(path) {
+    return path.replace(/^\/Users\/[^/]+/, '~');
+}
+export const SessionCard = memo(function SessionCard({ session, index, isSelected, }) {
+    const { symbol, color, label } = getStatusDisplay(session.status);
+    const dir = abbreviateHomePath(session.cwd);
+    const relativeTime = formatRelativeTime(session.updated_at);
+    const isRunning = session.status === 'running';
+    return (_jsxs(Box, { paddingX: 1, children: [_jsxs(Text, { color: isSelected ? 'cyan' : undefined, bold: isSelected, children: [isSelected ? '>' : ' ', " [", index + 1, "]"] }), _jsx(Text, { children: " " }), _jsx(Box, { width: 10, children: isRunning ? (_jsxs(_Fragment, { children: [_jsx(Spinner, { color: "green" }), _jsxs(Text, { color: color, children: [" ", label] })] })) : (_jsxs(Text, { color: color, children: [symbol, " ", label] })) }), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: relativeTime.padEnd(8) }), _jsx(Text, { color: isSelected ? 'white' : 'gray', children: dir })] }));
+});

package/dist/components/Spinner.d.ts

@@ -0,0 +1,7 @@
+import type React from 'react';
+interface SpinnerProps {
+    color?: string;
+}
+export declare function Spinner({ color }: SpinnerProps): React.ReactElement;
+export {};
+//# sourceMappingURL=Spinner.d.ts.map

package/dist/components/Spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Spinner.d.ts","sourceRoot":"","sources":["../../src/components/Spinner.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA0C/B,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,OAAO,CAAC,EAAE,KAAe,EAAE,EAAE,YAAY,GAAG,KAAK,CAAC,YAAY,CAI7E"}

package/dist/components/Spinner.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Text } from 'ink';
+import { useSyncExternalStore } from 'react';
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const FRAME_INTERVAL_MS = 120; // Slightly slower for less CPU usage
+// Shared global spinner state - only ONE timer for all spinners
+let globalFrame = 0;
+let subscriberCount = 0;
+let intervalId = null;
+const listeners = new Set();
+function subscribe(callback) {
+    listeners.add(callback);
+    subscriberCount++;
+    // Start timer only when first subscriber joins
+    if (subscriberCount === 1 && intervalId === null) {
+        intervalId = setInterval(() => {
+            globalFrame = (globalFrame + 1) % SPINNER_FRAMES.length;
+            for (const listener of listeners) {
+                listener();
+            }
+        }, FRAME_INTERVAL_MS);
+    }
+    return () => {
+        listeners.delete(callback);
+        subscriberCount--;
+        // Stop timer when last subscriber leaves
+        if (subscriberCount === 0 && intervalId !== null) {
+            clearInterval(intervalId);
+            intervalId = null;
+        }
+    };
+}
+function getSnapshot() {
+    return globalFrame;
+}
+export function Spinner({ color = 'green' }) {
+    const frame = useSyncExternalStore(subscribe, getSnapshot);
+    return _jsx(Text, { color: color, children: SPINNER_FRAMES[frame] });
+}

package/dist/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared constants for claude-code-monitor
+ */
+/** Package name used for npx commands */
+export declare const PACKAGE_NAME = "claude-code-monitor";
+/** Session timeout in milliseconds (30 minutes) */
+export declare const SESSION_TIMEOUT_MS: number;
+/** TTY cache TTL in milliseconds (30 seconds) */
+export declare const TTY_CACHE_TTL_MS = 30000;
+/** Hook event types supported by Claude Code */
+export declare const HOOK_EVENTS: readonly ["UserPromptSubmit", "PreToolUse", "PostToolUse", "Notification", "Stop"];
+export type HookEventName = (typeof HOOK_EVENTS)[number];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,yCAAyC;AACzC,eAAO,MAAM,YAAY,wBAAwB,CAAC;AAElD,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,QAAiB,CAAC;AAEjD,iDAAiD;AACjD,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC,gDAAgD;AAChD,eAAO,MAAM,WAAW,oFAMd,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/constants.js

@@ -0,0 +1,17 @@
+/**
+ * Shared constants for claude-code-monitor
+ */
+/** Package name used for npx commands */
+export const PACKAGE_NAME = 'claude-code-monitor';
+/** Session timeout in milliseconds (30 minutes) */
+export const SESSION_TIMEOUT_MS = 30 * 60 * 1000;
+/** TTY cache TTL in milliseconds (30 seconds) */
+export const TTY_CACHE_TTL_MS = 30_000;
+/** Hook event types supported by Claude Code */
+export const HOOK_EVENTS = [
+    'UserPromptSubmit',
+    'PreToolUse',
+    'PostToolUse',
+    'Notification',
+    'Stop',
+];

package/dist/hook/handler.d.ts

@@ -0,0 +1,9 @@
+import type { HookEventName } from '../types/index.js';
+/** @internal */
+export declare const VALID_HOOK_EVENTS: ReadonlySet<string>;
+/** @internal */
+export declare function isValidHookEventName(name: string): name is HookEventName;
+/** @internal */
+export declare function isNonEmptyString(value: unknown): value is string;
+export declare function handleHookEvent(eventName: string, tty?: string): Promise<void>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/hook/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/hook/handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlE,gBAAgB;AAChB,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAMhD,CAAC;AAEH,gBAAgB;AAChB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,aAAa,CAExE;AAED,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDpF"}

package/dist/hook/handler.js

@@ -0,0 +1,62 @@
+import { updateSession } from '../store/file-store.js';
+// Allowed hook event names (whitelist)
+/** @internal */
+export const VALID_HOOK_EVENTS = new Set([
+    'PreToolUse',
+    'PostToolUse',
+    'Notification',
+    'Stop',
+    'UserPromptSubmit',
+]);
+/** @internal */
+export function isValidHookEventName(name) {
+    return VALID_HOOK_EVENTS.has(name);
+}
+/** @internal */
+export function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+export async function handleHookEvent(eventName, tty) {
+    // Validate event name against whitelist
+    if (!isValidHookEventName(eventName)) {
+        console.error(`Invalid event name: ${eventName}`);
+        process.exit(1);
+    }
+    // Read JSON from stdin
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    const inputJson = Buffer.concat(chunks).toString('utf-8');
+    let hookPayload;
+    try {
+        hookPayload = JSON.parse(inputJson);
+    }
+    catch {
+        console.error('Invalid JSON input');
+        process.exit(1);
+    }
+    // Validate required fields
+    if (!isNonEmptyString(hookPayload.session_id)) {
+        console.error('Invalid or missing session_id');
+        process.exit(1);
+    }
+    // Validate optional fields if present
+    if (hookPayload.cwd !== undefined && typeof hookPayload.cwd !== 'string') {
+        console.error('Invalid cwd: must be a string');
+        process.exit(1);
+    }
+    if (hookPayload.notification_type !== undefined &&
+        typeof hookPayload.notification_type !== 'string') {
+        console.error('Invalid notification_type: must be a string');
+        process.exit(1);
+    }
+    const event = {
+        session_id: hookPayload.session_id,
+        cwd: hookPayload.cwd || process.cwd(),
+        tty,
+        hook_event_name: eventName,
+        notification_type: hookPayload.notification_type,
+    };
+    updateSession(event);
+}