@quantiya/codevibe-claude-plugin 1.0.9 → 1.0.10

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codevibe-claude",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Sync Claude Code sessions with iOS mobile app via AWS backend. Control Claude Code from your phone with real-time bidirectional synchronization.",
   "author": {
     "name": "CodeVibe Team"

package/README.md

@@ -6,8 +6,8 @@ Control Claude Code from your phone with real-time bidirectional synchronization
 
 - **Real-time Sync** - See desktop conversations on mobile instantly (~100-500ms latency)
 - **Mobile Control** - Send prompts from your phone that execute in the correct desktop session
-- **Locked Screen Support** - Works even when your Mac screen is locked (via tmux)
-- **Interactive Prompts** - Answer permission dialogs with numbered options (1=Yes, 2=Yes for project, 3=Reject)
+- **Locked Screen Support** - Works even when your screen is locked (via tmux)
+- **Interactive Prompts** - Answer permission dialogs with the same numbered options Claude Code shows in the terminal. Options are parsed dynamically from the live tmux pane at prompt time (Edit prompts typically show 3 options, Bash prompts show 2, and custom tools may offer more). Reply by typing or voice-inputting the option number on your phone — no dedicated approve/reject buttons.
 - **Voice Input** - Dictate prompts using iOS speech-to-text
 - **Image Attachments** - Send screenshots and photos with your messages
 - **Markdown Rendering** - Code blocks and formatting displayed beautifully
@@ -18,9 +18,9 @@ Control Claude Code from your phone with real-time bidirectional synchronization
 
 ## Prerequisites
 
-- **macOS** (darwin platform)
+- **macOS, Linux, or WSL Ubuntu** (WSL users: IPv6/browser-launching fixes are built into codevibe-core 1.0.3+)
 - **Node.js** 18.0.0 or higher
-- **tmux** (for locked screen support): `brew install tmux`
+- **tmux** (for locked screen support and mobile input): `brew install tmux` on macOS, `apt install tmux` on Linux/WSL
 - **Claude Code** with plugin system enabled
 
 ## Installation
@@ -75,7 +75,7 @@ codevibe-claude
 
 This wrapper:
 - Creates a tmux session for the Claude Code instance
-- Enables mobile prompts to work even when your Mac screen is locked
+- Enables mobile prompts to work even when your screen is locked
 - Supports multiple concurrent Claude Code sessions
 
 **Note:** Running `claude` directly without the wrapper will prevent mobile prompts from working when your screen is locked.
@@ -214,9 +214,11 @@ Not just `claude`.
 pkill -f "node dist/server.js"
 ```
 
-## Mac Power Settings (for Locked Screen Support)
+## Power Settings (for Locked Screen Support)
 
-To ensure mobile prompts work when your Mac screen is locked:
+For mobile prompts to keep working when your screen is locked, your computer needs to stay awake and its network connections need to survive sleep transitions.
+
+### macOS
 
 1. **System Settings** -> **Battery** (or **Energy**) -> Set "Computer sleep" to **Never** (when on power)
 2. In Terminal:
@@ -225,7 +227,13 @@ To ensure mobile prompts work when your Mac screen is locked:
    sudo pmset -a womp 1
    ```
 
-This keeps network connections alive during sleep.
+### Linux / WSL Ubuntu
+
+- Use your desktop environment's power settings to disable sleep on AC power (GNOME: Settings → Power; KDE: System Settings → Power Management)
+- Or from the command line: `systemd-inhibit --what=sleep:idle sleep infinity &` as a no-sleep placeholder
+- On WSL Ubuntu, the Windows host governs sleep. Configure Windows power settings to prevent the host from sleeping, and the WSL instance will remain active.
+
+This keeps network connections alive during sleep so mobile messages can still reach the plugin.
 
 ## Architecture
 

package/hooks/session-start.sh

@@ -35,6 +35,192 @@ else
   MAPPING_FILE=""
 fi
 
+# ─── Orphan daemon sweep ───────────────────────────────────────────────────
+#
+# When Claude Code terminates abnormally (crash, force-kill, window closed
+# without /exit, network drop), the SessionEnd hook doesn't fire and the
+# background daemon is never sent SIGTERM. Because the daemon is a PPID=1
+# process (detached from the hook that launched it), nothing in the OS
+# cleans it up — it keeps holding its AppSync subscription, sending
+# heartbeats, and showing the session as "desktop connected" on iOS forever.
+#
+# This sweep runs on every SessionStart and cleans up orphan daemons whose
+# tmux session no longer exists. Daemons belonging to live tmux sessions
+# (including our own) are left alone.
+#
+# Scope: the sweep only considers daemons that have an instance mapping file
+# (i.e. were launched under a tmux session). Daemons launched without tmux
+# have no mapping and cannot be safely identified as orphans, so we leave
+# them alone.
+#
+# Safety guards:
+#
+# (A) PID reuse: before killing a PID, verify via `ps -o command=` that the
+#     process is actually a node + codevibe-claude + server.js invocation.
+#     PIDs are recyclable (macOS cycles through ~32K), so a stale mapping
+#     from weeks ago could end up pointing at an unrelated user process.
+#     Without identity verification, we'd kill random things.
+#
+# (B) tmux unavailable: if the `tmux` binary is missing or fails for a reason
+#     other than "session doesn't exist", we conservatively treat the session
+#     as alive and leave the daemon alone. This prevents a degraded-tmux
+#     environment from causing a sweep-induced mass kill.
+
+# Check whether a PID is still identifiable as a codevibe-claude daemon.
+# Returns 0 if yes, non-zero otherwise.
+is_codevibe_daemon() {
+  local pid="$1"
+  local cmd
+  cmd=$(ps -o command= -p "$pid" 2>/dev/null)
+  # Pattern: "node" + "codevibe-claude" + "server.js" somewhere in the command line.
+  # Matches both the cache path (...codevibe-marketplace/codevibe-claude/X.Y.Z/dist/server.js)
+  # and the dev path (...codevibe-claude-plugin/dist/server.js).
+  case "$cmd" in
+    *node*codevibe-claude*server.js*) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+# Return 0 if the tmux session is alive OR we can't tell.
+# Return non-zero ONLY when we can prove the session is gone: tmux binary exists,
+# tmux server is reachable, and the server says this specific session doesn't exist.
+# Every other failure mode (no binary, server down, socket error, permission issue)
+# returns 0 — conservative, we'd rather leak a daemon than kill the wrong thing.
+tmux_session_alive() {
+  local tmux_name="$1"
+  if ! command -v tmux >/dev/null 2>&1; then
+    return 0  # no tmux binary → can't verify → assume alive
+  fi
+  # Verify the tmux server itself is reachable before trusting has-session.
+  # `tmux ls` exits 0 when the server is running and has at least one session.
+  # If it fails (server not running, socket error, no sessions at all), we can't
+  # reliably distinguish "this session is gone" from "tmux is broken." Conservative
+  # choice: assume the session might still be alive (or recoverable when the server
+  # comes back).
+  if ! tmux ls >/dev/null 2>&1; then
+    return 0  # server unreachable or empty → can't verify → assume alive
+  fi
+  # Server is confirmed reachable and has sessions. has-session non-zero now
+  # reliably means "this specific session does not exist."
+  tmux has-session -t "$tmux_name" 2>/dev/null
+}
+
+sweep_orphan_daemons() {
+  local swept=0
+  local kept=0
+  local cleaned_stale=0
+
+  # Pass 1: walk mapping files, which are the source of truth for (tmux_session, pid) pairs
+  shopt -s nullglob
+  local map_file
+  for map_file in "${CODEVIBE_TMPDIR}"/codevibe-claude-instance-*.json; do
+    # Extract tmux session name from filename
+    local orphan_tmux
+    orphan_tmux=$(basename "$map_file" .json | sed 's/^codevibe-claude-instance-//')
+
+    # Skip our own tmux session — we handle it in the existing reuse path below
+    if [ -n "$TMUX_SESSION" ] && [ "$orphan_tmux" = "$TMUX_SESSION" ]; then
+      continue
+    fi
+
+    local orphan_pid
+    orphan_pid=$(jq -r '.pid // empty' "$map_file" 2>/dev/null)
+
+    # Empty or missing PID in mapping — clean up the mapping file
+    if [ -z "$orphan_pid" ]; then
+      log "INFO" "Orphan sweep: removing mapping with no PID: $map_file"
+      rm -f "$map_file"
+      cleaned_stale=$((cleaned_stale + 1))
+      continue
+    fi
+
+    # PID is no longer running — clean up the stale mapping.
+    # NOTE: do NOT touch the pidfile or portfile by session UUID here. If /resume
+    # or a UUID collision caused a stale mapping to reference the same session
+    # UUID as a currently-live pidfile, we'd delete the live one. Pass 2 below
+    # handles pidfile cleanup by verifying each pidfile's content independently.
+    if ! ps -p "$orphan_pid" > /dev/null 2>&1; then
+      log "INFO" "Orphan sweep: removing stale mapping for dead PID $orphan_pid (tmux $orphan_tmux)"
+      rm -f "$map_file"
+      cleaned_stale=$((cleaned_stale + 1))
+      continue
+    fi
+
+    # PID is alive. Is its tmux session still alive (or unknowable)?
+    if tmux_session_alive "$orphan_tmux"; then
+      # Live other session — or tmux is unavailable and we can't tell. Either
+      # way, the conservative choice is to leave the daemon alone.
+      log "DEBUG" "Orphan sweep: tmux $orphan_tmux is alive (or tmux unavailable), leaving daemon $orphan_pid"
+      kept=$((kept + 1))
+      continue
+    fi
+
+    # tmux is gone but the PID is alive — looks like an orphan. But before
+    # killing, verify the PID actually belongs to a codevibe-claude daemon.
+    # If PID reuse has handed this PID to an unrelated process, we must not
+    # touch it. Just clean up the stale mapping and move on.
+    if ! is_codevibe_daemon "$orphan_pid"; then
+      log "INFO" "Orphan sweep: PID $orphan_pid is alive but is not a CodeVibe daemon (likely PID reused), removing stale mapping only"
+      rm -f "$map_file"
+      cleaned_stale=$((cleaned_stale + 1))
+      continue
+    fi
+
+    # Verified: this is our daemon and its tmux is gone. Kill it.
+    log "WARN" "Orphan sweep: killing orphan daemon PID $orphan_pid (tmux $orphan_tmux is gone)"
+
+    # SIGTERM first — lets the daemon run its graceful shutdown (mark session INACTIVE, etc.)
+    kill "$orphan_pid" 2>/dev/null || true
+
+    # Give it a moment to exit cleanly, then SIGKILL if it's still alive
+    sleep 0.5
+    if ps -p "$orphan_pid" > /dev/null 2>&1; then
+      log "WARN" "Orphan sweep: daemon $orphan_pid did not exit from SIGTERM, sending SIGKILL"
+      kill -9 "$orphan_pid" 2>/dev/null || true
+    fi
+
+    # Remove the mapping file. Do NOT touch pidfile/portfile by session UUID —
+    # Pass 2 below will pick up the now-dead PID and clean the pidfile (and its
+    # matching portfile) safely, based on PID content, not mapping contents.
+    rm -f "$map_file"
+    swept=$((swept + 1))
+  done
+
+  # Pass 2: defensive cleanup of stale pidfiles that have no mapping and are dead
+  # (e.g. daemons that died before writing a mapping file, or legacy non-tmux launches)
+  local pid_file
+  for pid_file in "${CODEVIBE_TMPDIR}"/codevibe-claude-*.pid; do
+    # Skip the instance-mapping files' PID files (they have 'instance' in the name and are .json not .pid,
+    # but be explicit in case the glob matches something unexpected)
+    local base
+    base=$(basename "$pid_file")
+    case "$base" in
+      codevibe-claude-instance-*) continue ;;
+    esac
+
+    local pid
+    pid=$(cat "$pid_file" 2>/dev/null)
+    if [ -z "$pid" ] || ! ps -p "$pid" > /dev/null 2>&1; then
+      log "INFO" "Orphan sweep: removing stale pidfile $pid_file (PID ${pid:-empty} not alive)"
+      rm -f "$pid_file"
+      # Also clean up the corresponding portfile
+      local port_file="${pid_file%.pid}.port"
+      rm -f "$port_file"
+      cleaned_stale=$((cleaned_stale + 1))
+    fi
+  done
+  shopt -u nullglob
+
+  if [ $swept -gt 0 ] || [ $cleaned_stale -gt 0 ]; then
+    log "INFO" "Orphan sweep: killed $swept orphan daemon(s), cleaned $cleaned_stale stale file(s), kept $kept live session(s)"
+  else
+    log "DEBUG" "Orphan sweep: nothing to clean (kept $kept live session(s))"
+  fi
+}
+
+# Run the sweep before touching the mapping file for our own session
+sweep_orphan_daemons || log "WARN" "Orphan sweep failed (non-fatal, continuing)"
+
 # Check if there's an MCP server running for this Claude Code instance
 EXISTING_SERVER_PORT=""
 EXISTING_SERVER_PID=""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantiya/codevibe-claude-plugin",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Mobile companion for Claude Code - monitor and control your Claude Code sessions from your phone with CodeVibe",
   "main": "dist/server.js",
   "bin": {