claude-live 2.0.4 → 2.0.6

package/.claude-plugin/hooks/hooks.json

@@ -1,101 +1,101 @@
 {
-  "description": "claude-live hooks — forwards Claude Code events to the visualizer",
+  "description": "claude-live hooks — auto-starts server on SessionStart, forwards all events to visualizer",
   "hooks": {
     "SessionStart": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
         "async": true
       }]
     }],
     "InstructionsLoaded": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "WorktreeCreate": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "WorktreeRemove": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "PreToolUse": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "PostToolUse": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "Stop": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "Notification": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "PermissionRequest": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "SubagentStart": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "SubagentStop": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "SessionEnd": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "PostToolUseFailure": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "UserPromptSubmit": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
@@ -103,7 +103,7 @@
       "match": { "trigger": ["manual", "auto"] },
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
@@ -111,49 +111,49 @@
       "match": { "trigger": ["manual", "auto"] },
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "StopFailure": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "TeammateIdle": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "TaskCompleted": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "ConfigChange": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "Elicitation": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }],
     "ElicitationResult": [{
       "hooks": [{
         "type": "command",
-        "command": "node $HOME/.claude/plugins/marketplaces/claude-live/bin/hook.js",
+        "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" send-event",
         "async": true
       }]
     }]

package/.claude-plugin/skills/diagnostics.md

@@ -0,0 +1,47 @@
+---
+name: diagnostics
+description: Show claude-live hook health — recent log entries, success/failure rates per target, and last errors
+trigger: explicit
+---
+
+Show a diagnostics report for claude-live hooks.
+
+## Log location
+
+Logs are written to `~/.config/claude-live/logs/YYYY-MM-DD.jsonl` — one JSON line per hook fire.
+
+## Steps
+
+1. Read today's log file: `~/.config/claude-live/logs/<today>.jsonl`
+   - If it doesn't exist, also try yesterday's
+   - If no logs exist at all, report: "No hook logs found — hooks may not be firing"
+
+2. Parse each line as JSON with fields: `ts`, `session_id`, `hook_event_name`, `tool_name`, `targets[]`
+   - Each target entry has: `url`, `ok` (bool), `ms`, optionally `error`
+
+3. Report:
+
+```
+claude-live diagnostics
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Log: ~/.config/claude-live/logs/<date>.jsonl
+Entries: <N> hooks fired
+
+Targets:
+  http://localhost:43451   ✓ 142/150  (94%)  avg 3ms
+  http://192.168.1.50:43451  ✗ 0/150   (0%)  — connection_error
+
+Last 5 entries:
+  14:23:01  PreToolUse    Bash         ✓ 2ms
+  14:23:00  PreToolUse    Read         ✓ 3ms
+  14:22:58  PostToolUse   Bash         ✓ 2ms
+  ...
+
+Recent errors (if any):
+  14:20:11  PostToolUse  Bash  http://192.168.1.50:43451  connection_error
+```
+
+4. If all targets are failing: suggest running `/claude-live start` or checking `/claude-live status`
+5. If no log file: suggest the user check that the plugin is enabled with `/reload-plugins`
+
+Use the Read tool to read the log file and Bash for `date` if needed. Keep output compact.

package/README.md

@@ -37,9 +37,16 @@ Run `npm root -g` to find your global node_modules path if the above doesn't wor
 
 ## Use
 
-```bash
-claude-live          # Start server (foreground)
-claude-live start    # Start server (detached)
+Once installed, use the `/claude-live:server` slash command in Claude Code:
+
+```
+/claude-live:server          # Check status, auto-start if needed
+/claude-live:server stop     # Stop the server
+/claude-live:server restart  # Restart the server
+/claude-live:server logs     # Show last 30 log lines
+/claude-live:server config   # Show current endpoint URL
+/claude-live:server config http://192.168.1.50:43451  # Set remote endpoint
+/claude-live:server config reset  # Reset to localhost default
 ```
 
 Then open http://localhost:43451 in your browser.
@@ -57,13 +64,22 @@ Multiple Claude sessions show as separate star systems. Prompts fly inward, resp
 
 Under the hood: the plugin sends every event to a lightweight Node.js server (pure passthrough, no persistence). The server broadcasts events to a PixiJS frontend via Server-Sent Events (SSE).
 
-## CLI
+## Server Endpoints
 
-```bash
-claude-live start       # Open visualization in browser
-claude-live stop        # Stop the server
-claude-live status      # Show server status
-```
+| Endpoint | Method | Description |
+|---|---|---|
+| `/hook` | POST | Receive hook events, broadcast to SSE clients |
+| `/events` | GET | SSE stream for the frontend |
+| `/health` | GET | Health check — returns `{"ok":true,"clients":<N>,"port":43451}` |
+
+## Troubleshooting
+
+| Symptom | Cause | Fix |
+|---|---|---|
+| No activity in browser | Hooks not firing | Run `/reload-plugins` or check `settings.json` hooks |
+| Server not reachable | Server not running | `/claude-live:server` auto-starts it |
+| `clients: 0` in `/health` | Server up, no browser tab open | Open `http://localhost:43451` |
+| Hook logs location | Debug delivery failures | `~/.config/claude-live/logs/YYYY-MM-DD.jsonl` |
 
 ## Development
 

package/bin/hook.js

@@ -1,24 +1,78 @@
 #!/usr/bin/env node
-// Reads a JSON event from stdin and POSTs it to the claude-live server.
-// Fails silently — must never block Claude Code.
 import { request } from 'http'
+import { request as httpsRequest } from 'https'
+import { readFileSync, mkdirSync, appendFileSync } from 'fs'
+import { homedir } from 'os'
+import { join } from 'path'
+
+const CONFIG_PATH = join(homedir(), '.config', 'claude-live', 'config.json')
+const LOG_DIR = join(homedir(), '.config', 'claude-live', 'logs')
+
+function getTargets() {
+  try {
+    const cfg = JSON.parse(readFileSync(CONFIG_PATH, 'utf8'))
+    if (Array.isArray(cfg.targets) && cfg.targets.length > 0) return cfg.targets
+    if (cfg.url) return [cfg.url]
+  } catch {}
+  return ['http://localhost:43451']
+}
+
+function writeLog(entry) {
+  try {
+    mkdirSync(LOG_DIR, { recursive: true })
+    const date = new Date().toISOString().slice(0, 10)
+    appendFileSync(join(LOG_DIR, `${date}.jsonl`), JSON.stringify(entry) + '\n')
+  } catch {}
+}
+
+function postToTarget(url, body) {
+  return new Promise(resolve => {
+    const start = Date.now()
+    try {
+      const parsed = new URL(url)
+      const isHttps = parsed.protocol === 'https:'
+      const req = (isHttps ? httpsRequest : request)({
+        hostname: parsed.hostname,
+        port: parsed.port || (isHttps ? 443 : 80),
+        path: '/hook',
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'Content-Length': body.length },
+        timeout: 2000,
+      }, res => {
+        res.resume()
+        resolve({ url, ok: res.statusCode === 200, ms: Date.now() - start })
+      })
+      req.on('error', () => resolve({ url, ok: false, ms: Date.now() - start, error: 'connection_error' }))
+      req.on('timeout', () => { req.destroy(); resolve({ url, ok: false, ms: Date.now() - start, error: 'timeout' }) })
+      req.end(body)
+    } catch (e) {
+      resolve({ url, ok: false, ms: Date.now() - start, error: e.message })
+    }
+  })
+}
 
 let data = ''
 process.stdin.setEncoding('utf8')
 process.stdin.on('data', c => data += c)
-process.stdin.on('end', () => {
+process.stdin.on('end', async () => {
   if (!data.trim()) process.exit(0)
+
   const body = Buffer.from(data)
-  const req = request({
-    hostname: '127.0.0.1',
-    port: parseInt(process.env.CLAUDE_LIVE_PORT || '43451', 10),
-    path: '/hook',
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json', 'Content-Length': body.length },
-    timeout: 2000,
+  const targets = getTargets()
+
+  let event = {}
+  try { event = JSON.parse(data) } catch {}
+
+  const results = await Promise.all(targets.map(url => postToTarget(url, body)))
+
+  writeLog({
+    ts: new Date().toISOString(),
+    session_id: event.session_id ?? null,
+    hook_event_name: event.hook_event_name ?? null,
+    tool_name: event.tool_name ?? null,
+    targets: results,
   })
-  req.on('error', () => {})
-  req.on('timeout', () => req.destroy())
-  req.end(body)
+
+  process.exit(0)
 })
-process.stdin.on('error', () => {})
+process.stdin.on('error', () => process.exit(0))

package/commands/{claude-live.md → server.md}

@@ -20,23 +20,29 @@ User's argument: $ARGUMENTS
 
 ## Status output (default and after start)
 
-Run these and display in a compact summary:
+Use `/health` endpoint — not SSE stream (SSE causes false negatives with short timeouts):
 
 ```
-curl -sf http://localhost:43451/events -o /dev/null -m 1 2>&1 && echo "● running on port 43451 — http://localhost:43451" || echo "○ stopped"
+curl -sf http://localhost:43451/health -m 2
+```
+
+Returns `{"ok":true,"clients":<N>,"port":43451}` when running.
+
+Also show:
+```
 ps -eo pid,etime,cmd | grep "node.*server/index.js" | grep -v grep
 tail -5 /tmp/claude-live.log 2>/dev/null
 ```
 
-Show: running/stopped, port (always 43451), PID and uptime if running, last 5 log lines.
+Show: running/stopped, port (always 43451), PID and uptime if running, client count, last 5 log lines.
 
 ## Config Management
 
-The `/claude-live config` subcommands manage where hooks send events.
+The `/claude-live:server config` subcommands manage where hooks send events.
 
 ### Display current URL
 ```
-/claude-live config
+/claude-live:server config
 ```
 Output example: `● Configured: http://192.168.1.50:43451 (from global config)`
 
@@ -48,7 +54,7 @@ Possible sources shown:
 
 ### Set global URL
 ```
-/claude-live config http://192.168.1.50:43451
+/claude-live:server config http://192.168.1.50:43451
 ```
 Output: `✓ URL set to http://192.168.1.50:43451`
 
@@ -70,7 +76,7 @@ Invalid URLs:
 
 ### Reset to default
 ```
-/claude-live config reset
+/claude-live:server config reset
 ```
 Output: `✓ Reset to default (localhost:43451)`
 

package/hooks/run-hook.cmd

@@ -0,0 +1,38 @@
+: << 'CMDBLOCK'
+@echo off
+REM Cross-platform polyglot wrapper for hook scripts.
+REM On Windows: cmd.exe runs the batch portion.
+REM On Unix: the shell interprets this as a script (: is a no-op).
+
+if "%~1"=="" (
+    echo run-hook.cmd: missing script name >&2
+    exit /b 1
+)
+
+set "HOOK_DIR=%~dp0"
+
+if exist "C:\Program Files\Git\bin\bash.exe" (
+    "C:\Program Files\Git\bin\bash.exe" "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
+    exit /b %ERRORLEVEL%
+)
+if exist "C:\Program Files (x86)\Git\bin\bash.exe" (
+    "C:\Program Files (x86)\Git\bin\bash.exe" "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
+    exit /b %ERRORLEVEL%
+)
+where bash >nul 2>nul
+if %ERRORLEVEL% equ 0 (
+    bash "%HOOK_DIR%%~1" %2 %3 %4 %5 %6 %7 %8 %9
+    exit /b %ERRORLEVEL%
+)
+exit /b 0
+CMDBLOCK
+
+# Unix: run the named script directly
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+if [ -z "${1:-}" ]; then
+    echo "run-hook.cmd: missing script name" >&2
+    exit 1
+fi
+SCRIPT_NAME="$1"
+shift
+exec bash "${SCRIPT_DIR}/${SCRIPT_NAME}" "$@"

package/hooks/send-event

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Forwards stdin event JSON to bin/hook.js. Fails silently.
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+exec node "${PLUGIN_ROOT}/bin/hook.js"

package/hooks/session-start

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+# SessionStart hook: auto-starts claude-live server if not running, then forwards event.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+SERVER="${PLUGIN_ROOT}/server/index.js"
+LOG="/tmp/claude-live.log"
+PORT="${CLAUDE_LIVE_PORT:-43451}"
+
+# Read stdin so it's available to forward
+input="$(cat)"
+
+# Check if server is already running.
+# /events is an SSE stream that never closes, so curl exits with 28 (timeout) on success.
+# We treat exit 0 (got data + closed) and 28 (timeout = streaming) as "server up".
+server_up() {
+    local code
+    curl -s "http://127.0.0.1:${PORT}/events" -o /dev/null -m 1 2>/dev/null
+    code=$?
+    [ "$code" -eq 0 ] || [ "$code" -eq 28 ]
+}
+
+if ! server_up; then
+    # Start server detached
+    nohup node "${SERVER}" >"${LOG}" 2>&1 &
+    disown
+    # Wait up to 3s for it to come up
+    for i in 1 2 3; do
+        sleep 1
+        server_up && break
+    done
+fi
+
+# Forward event to server (if it came up)
+if [ -n "$input" ]; then
+    printf '%s' "$input" | node "${PLUGIN_ROOT}/bin/hook.js" || true
+fi
+
+exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-live",
-  "version": "2.0.4",
+  "version": "2.0.6",
   "description": "Realtime Claude Code activity visualizer",
   "license": "MIT",
   "repository": "https://github.com/marisancans/claude-live",
@@ -19,7 +19,8 @@
     "bin/",
     "client/dist/",
     ".claude-plugin/",
-    "commands/"
+    "commands/",
+    "hooks/"
   ],
   "engines": {
     "node": ">=18"

package/server/index.js

@@ -52,6 +52,13 @@ const server = createServer((req, res) => {
     return
   }
 
+  // GET /health — health check
+  if (req.method === 'GET' && req.url === '/health') {
+    res.writeHead(200, { 'Content-Type': 'application/json' })
+    res.end(JSON.stringify({ ok: true, clients: clients.size, port: PORT }))
+    return
+  }
+
   // GET /events — SSE stream
   if (req.method === 'GET' && req.url === '/events') {
     res.writeHead(200, {