claude-live 0.1.0 → 0.4.0

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

@@ -1,37 +1,126 @@
 {
-  "PreToolUse": [{
-    "hooks": [{
-      "type": "command",
-      "command": "curl -sf -X POST http://localhost:43451/hook -H 'Content-Type: application/json' -d @- 2>/dev/null || true",
-      "async": true
+  "description": "claude-live hooks — forwards Claude Code events to the visualizer server",
+  "hooks": {
+    "SessionStart": [{
+      "hooks": [
+        {
+          "type": "command",
+          "command": "curl -sf http://localhost:43451/buffer >/dev/null 2>&1 || (npx claude-live@latest >/tmp/claude-live.log 2>&1 &)",
+          "async": true
+        },
+        {
+          "type": "command",
+          "command": "bin/send-hook.sh",
+          "async": true
+        }
+      ]
+    }],
+    "InstructionsLoaded": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "WorktreeCreate": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "WorktreeRemove": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "PreToolUse": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "PostToolUse": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "Stop": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "Notification": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "PermissionRequest": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "SubagentStart": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "SubagentStop": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "SessionEnd": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "PostToolUseFailure": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "UserPromptSubmit": [{
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "PreCompact": [{
+      "match": { "trigger": ["manual", "auto"] },
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
+    }],
+    "PostCompact": [{
+      "match": { "trigger": ["manual", "auto"] },
+      "hooks": [{
+        "type": "command",
+        "command": "bin/send-hook.sh",
+        "async": true
+      }]
     }]
-  }],
-  "PostToolUse": [{
-    "hooks": [{
-      "type": "command",
-      "command": "curl -sf -X POST http://localhost:43451/hook -H 'Content-Type: application/json' -d @- 2>/dev/null || true",
-      "async": true
-    }]
-  }],
-  "Stop": [{
-    "hooks": [{
-      "type": "command",
-      "command": "curl -sf -X POST http://localhost:43451/hook -H 'Content-Type: application/json' -d @- 2>/dev/null || true",
-      "async": true
-    }]
-  }],
-  "Notification": [{
-    "hooks": [{
-      "type": "command",
-      "command": "curl -sf -X POST http://localhost:43451/hook -H 'Content-Type: application/json' -d @- 2>/dev/null || true",
-      "async": true
-    }]
-  }],
-  "PermissionRequest": [{
-    "hooks": [{
-      "type": "command",
-      "command": "curl -sf -X POST http://localhost:43451/hook -H 'Content-Type: application/json' -d @- 2>/dev/null || true",
-      "async": true
-    }]
-  }]
+  }
 }

package/.claude-plugin/marketplace.json

@@ -0,0 +1,29 @@
+{
+  "name": "claude-live",
+  "owner": {
+    "name": "marisancans"
+  },
+  "metadata": {
+    "description": "Realtime solar system visualizer for Claude Code sessions",
+    "version": "0.2.0"
+  },
+  "plugins": [
+    {
+      "name": "claude-live",
+      "source": "./",
+      "description": "Watch your Claude Code sessions rendered as a living solar system. Files orbit as planets, operations fire directional lasers, parallel sessions glow as separate star clusters.",
+      "version": "0.2.0",
+      "author": {
+        "name": "marisancans"
+      },
+      "category": "development",
+      "keywords": [
+        "visualizer",
+        "activity",
+        "realtime",
+        "orbit",
+        "solar-system"
+      ]
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -1,9 +1,8 @@
 {
   "name": "claude-live",
-  "version": "0.1.0",
+  "version": "0.4.0",
   "description": "Realtime solar system visualizer for Claude Code sessions",
   "author": { "name": "marisancans" },
   "repository": "https://github.com/marisancans/claude-live",
-  "keywords": ["visualizer", "activity", "realtime", "orbit"],
-  "hooks": "./hooks/hooks.json"
+  "keywords": ["visualizer", "activity", "realtime", "orbit"]
 }

package/bin/claude-live.js

@@ -6,24 +6,21 @@ const portArgIdx = process.argv.findIndex(a => a === '--port' || a.startsWith('-
 const portArg = portArgIdx >= 0
   ? (process.argv[portArgIdx].includes('=') ? process.argv[portArgIdx].split('=')[1] : process.argv[portArgIdx + 1])
   : '43451'
-const desiredPort = parseInt(portArg, 10)
+const port = parseInt(portArg, 10)
 
-let p = desiredPort
-const tryStart = async () => {
-  try {
-    const { port } = await createServer({ port: p })
-    const url = `http://localhost:${port}`
-    console.log(`claude-live running at ${url}`)
-    if (p !== desiredPort) {
-      console.log(`(port ${desiredPort} was in use)`)
-      console.log(`Update your hook command to use port ${port}`)
-    }
-    console.log('\nAdd this to ~/.claude/settings.json hooks:')
-    console.log(`  curl -s -X POST ${url}/hook -H 'Content-Type: application/json' -d @- || true`)
-    open(url)
-  } catch (e) {
-    if (e.code === 'EADDRINUSE') { p++; tryStart() }
-    else { console.error(e); process.exit(1) }
+try {
+  await createServer({ port })
+  const url = `http://localhost:${port}`
+  console.log(`claude-live running at ${url}`)
+  open(url)
+} catch (e) {
+  if (e.code === 'EADDRINUSE') {
+    console.error(`Port ${port} is already in use.`)
+    console.error(`Either claude-live is already running, or another process is using port ${port}.`)
+    console.error(`Check: curl http://localhost:${port}/buffer`)
+    process.exit(1)
+  } else {
+    console.error(e)
+    process.exit(1)
   }
 }
-tryStart()

package/bin/send-hook.sh

@@ -0,0 +1,34 @@
+#!/bin/sh
+# claude-live hook forwarder — reads URL from config with precedence:
+#   1. CLAUDE_LIVE_URL env var (override)
+#   2. .claude/claude-live.json (project)
+#   3. ~/.config/claude-live/config.json (global)
+#   4. http://localhost:43451 (default)
+
+URL=""
+
+# Debug: log that hook was called
+echo "[claude-live-hook] hook called" >> /tmp/claude-live-hook.log 2>&1
+
+# Project-level config
+if [ -f ".claude/claude-live.json" ]; then
+  URL=$(cat .claude/claude-live.json 2>/dev/null | grep -o '"url" *: *"[^"]*"' | head -1 | sed 's/.*: *"//;s/"//')
+fi
+
+# Global config fallback
+if [ -z "$URL" ] && [ -f "$HOME/.config/claude-live/config.json" ]; then
+  URL=$(cat "$HOME/.config/claude-live/config.json" 2>/dev/null | grep -o '"url" *: *"[^"]*"' | head -1 | sed 's/.*: *"//;s/"//')
+fi
+
+# Env var override
+if [ -n "$CLAUDE_LIVE_URL" ]; then
+  URL="$CLAUDE_LIVE_URL"
+fi
+
+# Default
+URL="${URL:-http://localhost:43451}"
+
+# Debug: log what URL we're using and what we're sending
+echo "[claude-live-hook] sending to $URL" >> /tmp/claude-live-hook.log 2>&1
+
+curl -sf -X POST "$URL/hook" -H 'Content-Type: application/json' -d @- 2>/tmp/claude-live-hook-error.log || true

package/bin/start-server.sh

@@ -0,0 +1,33 @@
+#!/bin/sh
+# claude-live server launcher — reads URL from config with precedence:
+#   1. CLAUDE_LIVE_URL env var (override)
+#   2. .claude/claude-live.json (project)
+#   3. ~/.config/claude-live/config.json (global)
+#   4. http://localhost:43451 (default)
+
+URL=""
+
+# Project-level config
+if [ -f ".claude/claude-live.json" ]; then
+  URL=$(cat .claude/claude-live.json 2>/dev/null | grep -o '"url" *: *"[^"]*"' | head -1 | sed 's/.*: *"//;s/"//')
+fi
+
+# Global config fallback
+if [ -z "$URL" ] && [ -f "$HOME/.config/claude-live/config.json" ]; then
+  URL=$(cat "$HOME/.config/claude-live/config.json" 2>/dev/null | grep -o '"url" *: *"[^"]*"' | head -1 | sed 's/.*: *"//;s/"//')
+fi
+
+# Env var override
+if [ -n "$CLAUDE_LIVE_URL" ]; then
+  URL="$CLAUDE_LIVE_URL"
+fi
+
+# Default
+URL="${URL:-http://localhost:43451}"
+
+# Only auto-start server if pointing to localhost
+case "$URL" in
+  http://localhost:*|http://127.0.0.1:*)
+    curl -sf "$URL/buffer" >/dev/null 2>&1 || (npx claude-live@latest >/tmp/claude-live.log 2>&1 &)
+    ;;
+esac