@quantiya/codevibe-claude-plugin 1.0.0

package/hooks/notification.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+
+# Notification Hook
+# Triggered when Claude Code shows a notification
+# Forwards notifications to mobile app
+
+# Source common utilities
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+log "INFO" "Notification hook triggered"
+
+# Read JSON input from stdin
+INPUT=$(read_json_input)
+
+log "DEBUG" "Input: $INPUT"
+
+# Extract session ID for dynamic port lookup
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty')
+
+# Send to MCP server
+send_to_mcp "event" "$INPUT" "$SESSION_ID"
+
+EXIT_CODE=$?
+
+if [ $EXIT_CODE -eq 0 ]; then
+  log "INFO" "Notification event sent successfully"
+else
+  log "ERROR" "Failed to send Notification event (exit code: $EXIT_CODE)"
+fi
+
+exit $EXIT_CODE

package/hooks/permission-request.sh

@@ -0,0 +1,191 @@
+#!/bin/bash
+
+# PermissionRequest Hook
+# Triggered when Claude asks for user permission (Y/n prompts)
+# Captures interactive prompts and can forward to mobile for remote approval
+# Also extracts any assistant responses from the transcript that haven't been sent yet
+
+# Source common utilities
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+log "INFO" "PermissionRequest hook triggered"
+
+# Read JSON input from stdin
+INPUT=$(read_json_input)
+
+log "DEBUG" "Input: $INPUT"
+
+# Extract fields from permission request
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty')
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+TOOL_INPUT=$(echo "$INPUT" | jq -c '.tool_input // {}')
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // empty')
+
+if [ -z "$SESSION_ID" ]; then
+  log "ERROR" "No session_id found in permission request"
+  exit 1
+fi
+
+# ============================================================
+# FIRST: Extract and send any assistant responses from transcript
+# This captures assistant text written BEFORE the tool permission request
+# ============================================================
+
+# Track sent message UUIDs to avoid duplicates across multiple PermissionRequest calls
+SENT_UUIDS_FILE="${CODEVIBE_TMPDIR}/codevibe-claude-sent-uuids-${SESSION_ID}.txt"
+
+if [ -n "$TRANSCRIPT_PATH" ] && [ -f "$TRANSCRIPT_PATH" ]; then
+  log "DEBUG" "Reading transcript for assistant responses: $TRANSCRIPT_PATH"
+
+  # Get the last user prompt UUID to know where assistant messages start
+  LAST_USER_UUID=$(grep '"type":"user"' "$TRANSCRIPT_PATH" | tail -1 | jq -r '.uuid // empty')
+
+  if [ -n "$LAST_USER_UUID" ]; then
+    log "DEBUG" "Last user prompt UUID: $LAST_USER_UUID"
+
+    # Track assistant messages in current turn (chained by parentUuid)
+    declare -a CURRENT_TURN_UUIDS
+    CURRENT_TURN_UUIDS=("$LAST_USER_UUID")
+
+    # First pass: build the complete UUID chain including both assistant and user (tool_result) messages
+    # This is needed because the chain goes: user_prompt -> assistant -> user(tool_result) -> assistant -> ...
+    while IFS= read -r line; do
+      PARENT_UUID=$(echo "$line" | jq -r '.parentUuid // empty')
+      MESSAGE_UUID=$(echo "$line" | jq -r '.uuid // empty')
+
+      # Check if parent is in current turn - if so, add this UUID to the chain
+      for turn_uuid in "${CURRENT_TURN_UUIDS[@]}"; do
+        if [ "$PARENT_UUID" = "$turn_uuid" ]; then
+          CURRENT_TURN_UUIDS+=("$MESSAGE_UUID")
+          break
+        fi
+      done
+    done < "$TRANSCRIPT_PATH"
+
+    log "DEBUG" "Built UUID chain with ${#CURRENT_TURN_UUIDS[@]} entries"
+
+    # Second pass: extract and send assistant text messages that are in the chain
+    while IFS= read -r line; do
+      MESSAGE_UUID=$(echo "$line" | jq -r '.uuid // empty')
+
+      # Check if this message is in our turn chain
+      IS_CURRENT_TURN=false
+      for turn_uuid in "${CURRENT_TURN_UUIDS[@]}"; do
+        if [ "$MESSAGE_UUID" = "$turn_uuid" ]; then
+          IS_CURRENT_TURN=true
+          break
+        fi
+      done
+
+      if [ "$IS_CURRENT_TURN" = false ]; then
+        continue
+      fi
+
+      # Skip if this message UUID was already sent
+      if [ -f "$SENT_UUIDS_FILE" ] && grep -q "^${MESSAGE_UUID}$" "$SENT_UUIDS_FILE"; then
+        log "DEBUG" "Skipping already sent message UUID: $MESSAGE_UUID"
+        continue
+      fi
+
+      MESSAGE_CONTENT=$(echo "$line" | jq -r '.message.content // empty')
+
+      if [ -z "$MESSAGE_CONTENT" ] || [ "$MESSAGE_CONTENT" = "null" ]; then
+        continue
+      fi
+
+      # Extract text content from assistant message
+      TEXT_CONTENT=$(echo "$line" | jq -r '.message.content[] | select(.type == "text") | .text // empty' | tr '\n' ' ')
+
+      if [ -n "$TEXT_CONTENT" ] && [ "$TEXT_CONTENT" != "null" ]; then
+        # Create ASSISTANT_RESPONSE event
+        ASSISTANT_PAYLOAD=$(jq -n \
+          --arg session_id "$SESSION_ID" \
+          --arg content "$TEXT_CONTENT" \
+          --arg hook_event_name "PermissionRequest" \
+          --arg type "ASSISTANT_RESPONSE" \
+          '{
+            session_id: $session_id,
+            hook_event_name: $hook_event_name,
+            type: $type,
+            content: $content
+          }')
+
+        log "DEBUG" "Sending assistant response from PermissionRequest: ${TEXT_CONTENT:0:100}..."
+
+        send_to_mcp "event" "$ASSISTANT_PAYLOAD" "$SESSION_ID"
+
+        if [ $? -eq 0 ]; then
+          log "INFO" "Assistant response sent successfully from PermissionRequest hook"
+          # Track that this message UUID was sent
+          echo "$MESSAGE_UUID" >> "$SENT_UUIDS_FILE"
+        else
+          log "ERROR" "Failed to send assistant response from PermissionRequest hook"
+        fi
+      fi
+    done < <(grep '"type":"assistant"' "$TRANSCRIPT_PATH")
+  fi
+else
+  log "WARN" "Transcript path not found or file doesn't exist: $TRANSCRIPT_PATH"
+fi
+
+# ============================================================
+# SECOND: Send the INTERACTIVE_PROMPT event for the tool permission
+# ============================================================
+
+# Create question text based on tool type
+# Include file path for file operations, command for Bash, etc.
+QUESTION_TEXT=""
+if [ "$TOOL_NAME" = "Edit" ]; then
+  QUESTION_TEXT="Do you want to allow Edit operation on ${FILE_PATH}?"
+elif [ "$TOOL_NAME" = "Write" ]; then
+  QUESTION_TEXT="Do you want to allow Write operation to ${FILE_PATH}?"
+elif [ "$TOOL_NAME" = "Read" ]; then
+  QUESTION_TEXT="Do you want to allow Read operation on ${FILE_PATH}?"
+elif [ "$TOOL_NAME" = "Bash" ]; then
+  # Keep it simple - detailed command visible via "Tap to see details"
+  QUESTION_TEXT="Do you want to allow Bash operation?"
+elif [ -n "$TOOL_NAME" ] && [ -n "$FILE_PATH" ]; then
+  QUESTION_TEXT="Do you want to allow ${TOOL_NAME} operation on ${FILE_PATH}?"
+elif [ -n "$TOOL_NAME" ]; then
+  QUESTION_TEXT="Do you want to allow ${TOOL_NAME} operation?"
+else
+  QUESTION_TEXT="Do you want to allow this operation?"
+fi
+
+log "DEBUG" "Creating INTERACTIVE_PROMPT for: $QUESTION_TEXT"
+
+# Create INTERACTIVE_PROMPT event (options will be added dynamically by server via tmux parsing)
+EVENT_PAYLOAD=$(jq -n \
+  --arg session_id "$SESSION_ID" \
+  --arg hook_event_name "PermissionRequest" \
+  --arg type "INTERACTIVE_PROMPT" \
+  --arg content "$QUESTION_TEXT" \
+  --arg tool_name "$TOOL_NAME" \
+  --argjson tool_input "$TOOL_INPUT" \
+  '{
+    session_id: $session_id,
+    hook_event_name: $hook_event_name,
+    type: $type,
+    content: $content,
+    metadata: {
+      tool_name: $tool_name,
+      tool_input: $tool_input
+    }
+  }')
+
+log "DEBUG" "Event payload: $EVENT_PAYLOAD"
+
+# Send INTERACTIVE_PROMPT event to MCP server (pass session_id for dynamic port lookup)
+send_to_mcp "event" "$EVENT_PAYLOAD" "$SESSION_ID"
+
+EXIT_CODE=$?
+
+if [ $EXIT_CODE -eq 0 ]; then
+  log "INFO" "PermissionRequest INTERACTIVE_PROMPT event sent successfully"
+else
+  log "ERROR" "Failed to send PermissionRequest event (exit code: $EXIT_CODE)"
+fi
+
+exit $EXIT_CODE

package/hooks/post-tool-use.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+
+# PostToolUse Hook
+# Triggered after Claude uses a tool (Read, Edit, Write, etc.)
+# Captures tool usage and file changes
+
+# Source common utilities
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+log "INFO" "PostToolUse hook triggered"
+
+# Read JSON input from stdin
+INPUT=$(read_json_input)
+
+log "DEBUG" "Input: $INPUT"
+
+# Extract tool name to check if it's a file operation
+TOOL_NAME=$(echo "$INPUT" | grep -o '"tool_name"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/"tool_name"[[:space:]]*:[[:space:]]*"\([^"]*\)"/\1/')
+
+log "DEBUG" "Tool name: $TOOL_NAME"
+
+# Extract session ID for dynamic port lookup
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty')
+
+# Send tool use event to MCP server
+send_to_mcp "event" "$INPUT" "$SESSION_ID"
+EVENT_EXIT_CODE=$?
+
+if [ $EVENT_EXIT_CODE -eq 0 ]; then
+  log "INFO" "PostToolUse event sent successfully"
+else
+  log "ERROR" "Failed to send PostToolUse event (exit code: $EVENT_EXIT_CODE)"
+fi
+
+# Note: File operations (Read, Edit, Write) are already captured in the TOOL_USE event above
+# The tool_input and tool_response contain all necessary information including file paths and diffs
+# iOS app can filter TOOL_USE events to display file changes
+
+log "DEBUG" "PostToolUse event processing completed"
+
+exit $EVENT_EXIT_CODE

package/hooks/session-end.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+
+# SessionEnd Hook
+# Triggered when a Claude Code session ends
+# Cleans up sync session and unsubscribes from mobile events
+
+# Source common utilities
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+log "INFO" "SessionEnd hook triggered"
+
+# Read JSON input from stdin
+INPUT=$(read_json_input)
+
+log "DEBUG" "Input: $INPUT"
+
+# Extract session ID for dynamic port lookup
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty')
+
+# Send to MCP server
+send_to_mcp "event" "$INPUT" "$SESSION_ID"
+
+EXIT_CODE=$?
+
+if [ $EXIT_CODE -eq 0 ]; then
+  log "INFO" "SessionEnd event sent successfully"
+
+  # Clean up session-specific files
+  if [ -n "$SESSION_ID" ]; then
+    PID_FILE="${CODEVIBE_TMPDIR}/codevibe-claude-${SESSION_ID}.pid"
+    PORT_FILE="${CODEVIBE_TMPDIR}/codevibe-claude-${SESSION_ID}.port"
+
+    # Kill the MCP server for this session
+    if [ -f "$PID_FILE" ]; then
+      PID=$(cat "$PID_FILE")
+      if ps -p "$PID" > /dev/null 2>&1; then
+        log "INFO" "Stopping MCP server for session $SESSION_ID (PID: $PID)"
+        kill "$PID" 2>/dev/null || true
+      fi
+      rm -f "$PID_FILE"
+    fi
+
+    # Remove port file (should also be cleaned up by server, but just in case)
+    rm -f "$PORT_FILE"
+
+    # Remove sent UUIDs tracking file
+    SENT_UUIDS_FILE="${CODEVIBE_TMPDIR}/codevibe-claude-sent-uuids-${SESSION_ID}.txt"
+    rm -f "$SENT_UUIDS_FILE"
+
+    log "INFO" "Session cleanup completed for $SESSION_ID"
+  fi
+else
+  log "ERROR" "Failed to send SessionEnd event (exit code: $EXIT_CODE)"
+fi
+
+exit $EXIT_CODE

package/hooks/session-start.sh

@@ -0,0 +1,127 @@
+#!/bin/bash
+
+# SessionStart Hook
+# Triggered when a Claude Code session starts or resumes
+# Initializes sync session and subscribes to mobile events
+
+# Source common utilities
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+log "INFO" "SessionStart hook triggered"
+
+# Read JSON input from stdin first so we can get the session ID
+INPUT=$(read_json_input)
+log "DEBUG" "Input: $INPUT"
+
+# Extract session ID from input
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty')
+if [ -z "$SESSION_ID" ]; then
+  log "ERROR" "No session_id in input"
+  exit 1
+fi
+
+log "INFO" "Session ID: $SESSION_ID"
+
+# Find the plugin root directory (parent of hooks directory)
+PLUGIN_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Mapping file tracks which MCP server is running for this Claude Code instance (tmux session)
+TMUX_SESSION="${CODEVIBE_TMUX_SESSION:-}"
+if [ -n "$TMUX_SESSION" ]; then
+  MAPPING_FILE="${CODEVIBE_TMPDIR}/codevibe-claude-instance-${TMUX_SESSION}.json"
+else
+  # Fallback: use session-specific files if no tmux session
+  MAPPING_FILE=""
+fi
+
+# Check if there's an MCP server running for this Claude Code instance
+EXISTING_SERVER_PORT=""
+EXISTING_SERVER_PID=""
+if [ -n "$MAPPING_FILE" ] && [ -f "$MAPPING_FILE" ]; then
+  EXISTING_SERVER_PORT=$(jq -r '.port // empty' "$MAPPING_FILE" 2>/dev/null)
+  EXISTING_SERVER_PID=$(jq -r '.pid // empty' "$MAPPING_FILE" 2>/dev/null)
+  OLD_SESSION_ID=$(jq -r '.session // empty' "$MAPPING_FILE" 2>/dev/null)
+
+  if [ -n "$EXISTING_SERVER_PID" ] && ps -p "$EXISTING_SERVER_PID" > /dev/null 2>&1; then
+    log "INFO" "Found running MCP server for this instance (session: $OLD_SESSION_ID, port: $EXISTING_SERVER_PORT, pid: $EXISTING_SERVER_PID)"
+  else
+    log "INFO" "MCP server from mapping not running, will start new one"
+    EXISTING_SERVER_PORT=""
+    EXISTING_SERVER_PID=""
+    rm -f "$MAPPING_FILE"
+  fi
+fi
+
+# If existing server found, send event to it and let it handle session transition
+if [ -n "$EXISTING_SERVER_PORT" ]; then
+  log "INFO" "Using existing MCP server on port $EXISTING_SERVER_PORT for session $SESSION_ID"
+  RESPONSE=$(curl -s -X POST "http://localhost:${EXISTING_SERVER_PORT}/event" \
+    -H "Content-Type: application/json" \
+    -d "$INPUT" 2>&1)
+  CURL_EXIT=$?
+  if [ $CURL_EXIT -eq 0 ]; then
+    log "INFO" "SessionStart event sent to existing server"
+    # Update mapping with new session ID
+    echo "{\"session\":\"$SESSION_ID\",\"port\":$EXISTING_SERVER_PORT,\"pid\":$EXISTING_SERVER_PID}" > "$MAPPING_FILE"
+    log "INFO" "Updated mapping for session $SESSION_ID"
+    exit 0
+  else
+    log "WARN" "Failed to send to existing server (exit: $CURL_EXIT), will start new one"
+  fi
+fi
+
+# No running server found, start a new one
+PID_FILE="${CODEVIBE_TMPDIR}/codevibe-claude-${SESSION_ID}.pid"
+PORT_FILE="${CODEVIBE_TMPDIR}/codevibe-claude-${SESSION_ID}.port"
+
+# Start the MCP server with the session ID
+# Pass CODEVIBE_TMUX_SESSION so server can use tmux send-keys for mobile input
+# Change to plugin directory so .env file can be found by dotenvx
+log "INFO" "Starting MCP server for session $SESSION_ID..."
+log "DEBUG" "CODEVIBE_TMUX_SESSION=${CODEVIBE_TMUX_SESSION:-not set}"
+log "DEBUG" "ENVIRONMENT=${ENVIRONMENT:-development}"
+log "DEBUG" "Starting server from directory: $PLUGIN_ROOT"
+# Use exec to replace subshell with node process so $! captures correct PID
+# Pass through ENVIRONMENT variable for correct Cognito configuration
+(cd "$PLUGIN_ROOT" && exec env CODEVIBE_TMUX_SESSION="${CODEVIBE_TMUX_SESSION}" ENVIRONMENT="${ENVIRONMENT:-development}" node "$PLUGIN_ROOT/dist/server.js" "$SESSION_ID") >> "${CODEVIBE_TMPDIR}/codevibe-claude-mcp.log" 2>&1 &
+SERVER_PID=$!
+echo "$SERVER_PID" > "$PID_FILE"
+
+# Wait for server to start and port file to be created
+MAX_WAIT=10
+WAITED=0
+while [ ! -f "$PORT_FILE" ] && [ $WAITED -lt $MAX_WAIT ]; do
+  sleep 0.5
+  WAITED=$((WAITED + 1))
+  log "DEBUG" "Waiting for port file... ($WAITED)"
+done
+
+if [ -f "$PORT_FILE" ]; then
+  PORT=$(cat "$PORT_FILE")
+  log "INFO" "MCP server started (PID: $SERVER_PID, Port: $PORT)"
+  # Create mapping file for this Claude Code instance
+  if [ -n "$MAPPING_FILE" ]; then
+    echo "{\"session\":\"$SESSION_ID\",\"port\":$PORT,\"pid\":$SERVER_PID}" > "$MAPPING_FILE"
+    log "INFO" "Created mapping file: $MAPPING_FILE"
+  fi
+else
+  log "WARN" "Port file not created after ${MAX_WAIT}s, server may have failed to start"
+fi
+
+# Send to MCP server
+send_to_mcp "event" "$INPUT" "$SESSION_ID"
+
+EXIT_CODE=$?
+
+if [ $EXIT_CODE -eq 0 ]; then
+  log "INFO" "SessionStart event sent successfully"
+else
+  # Don't fail the hook if auth is missing - just warn
+  # This allows users to run claude without logging in first
+  log "WARN" "Failed to send SessionStart event (exit code: $EXIT_CODE)"
+  log "WARN" "Run 'codevibe-claude login' to enable mobile sync"
+fi
+
+# Always exit 0 to avoid blocking Claude Code startup
+exit 0