ghost-tab 2.6.0

package/lib/menu-tui.sh

@@ -0,0 +1,189 @@
+#!/bin/bash
+# TUI wrapper for main menu
+# Uses ghost-tab-tui main-menu subcommand
+
+# Compute the target path for a new worktree.
+# Args: project_path project_name branch worktree_base
+# Outputs the computed path to stdout.
+compute_worktree_path() {
+  local project_path="$1"
+  local project_name="$2"
+  local branch="$3"
+  local worktree_base="$4"
+
+  # Sanitize branch name: strip origin/ prefix, replace / with -
+  local sanitized="${branch#origin/}"
+  sanitized="${sanitized//\//-}"
+
+  if [[ -n "$worktree_base" ]]; then
+    echo "${worktree_base}/${project_name}--${sanitized}"
+  else
+    local parent_dir
+    parent_dir="$(dirname "$project_path")"
+    echo "${parent_dir}/${project_name}--${sanitized}"
+  fi
+}
+
+# Interactive project selection using ghost-tab-tui main-menu
+# Returns 0 if an actionable item was selected, 1 if quit/cancelled
+# Sets: _selected_project_name, _selected_project_path, _selected_project_action, _selected_ai_tool
+select_project_interactive() {
+  local projects_file="$1"
+
+  if ! command -v ghost-tab-tui &>/dev/null; then
+    error "ghost-tab-tui binary not found. Please reinstall."
+    return 1
+  fi
+
+  # Read preferences from settings file
+  local ghost_display="animated"
+  local tab_title="full"
+  local settings_file="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab/settings"
+  if [ -f "$settings_file" ]; then
+    local saved_display
+    saved_display=$(grep '^ghost_display=' "$settings_file" 2>/dev/null | cut -d= -f2)
+    if [ -n "$saved_display" ]; then
+      ghost_display="$saved_display"
+    fi
+    local saved_tab_title
+    saved_tab_title=$(grep '^tab_title=' "$settings_file" 2>/dev/null | cut -d= -f2)
+    if [ -n "$saved_tab_title" ]; then
+      tab_title="$saved_tab_title"
+    fi
+  fi
+
+  # Read sound notification state
+  local sound_name=""
+  local gt_config_dir="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab"
+  if type get_sound_name &>/dev/null; then
+    sound_name="$(get_sound_name "${SELECTED_AI_TOOL:-claude}" "$gt_config_dir")"
+  fi
+
+  # Build AI tools comma-separated list
+  local ai_tools_csv
+  ai_tools_csv=$(IFS=,; echo "${AI_TOOLS_AVAILABLE[*]}")
+
+  # Build command args
+  local ai_tool_file="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab/ai-tool"
+  local cmd_args=("main-menu" "--projects-file" "$projects_file")
+  cmd_args+=("--ai-tool" "${SELECTED_AI_TOOL:-claude}")
+  cmd_args+=("--ai-tools" "$ai_tools_csv")
+  cmd_args+=("--ai-tool-file" "$ai_tool_file")
+  cmd_args+=("--ghost-display" "$ghost_display")
+  cmd_args+=("--tab-title" "$tab_title")
+  cmd_args+=("--settings-file" "$settings_file")
+  local sound_file="$gt_config_dir/${SELECTED_AI_TOOL:-claude}-features.json"
+  cmd_args+=("--sound-file" "$sound_file")
+  if [[ -n "$sound_name" ]]; then
+    cmd_args+=("--sound-name" "$sound_name")
+  fi
+  if [ -n "${_update_version:-}" ]; then
+    cmd_args+=("--update-version" "$_update_version")
+  fi
+
+  local result
+  if ! result=$(ghost-tab-tui "${cmd_args[@]}" 2>/dev/null); then
+    return 1
+  fi
+
+  local action
+  if ! action=$(echo "$result" | jq -r '.action' 2>/dev/null); then
+    error "Failed to parse menu response"
+    return 1
+  fi
+
+  if [[ -z "$action" || "$action" == "null" ]]; then
+    return 1
+  fi
+
+  # Update AI tool if changed (persist regardless of exit action)
+  local ai_tool
+  ai_tool=$(echo "$result" | jq -r '.ai_tool // ""' 2>/dev/null)
+  if [[ -n "$ai_tool" && "$ai_tool" != "null" ]]; then
+    _selected_ai_tool="$ai_tool"
+    # Persist for next session if tool changed
+    if [[ "$ai_tool" != "${SELECTED_AI_TOOL:-}" ]]; then
+      local ai_tool_file="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab/ai-tool"
+      mkdir -p "$(dirname "$ai_tool_file")"
+      echo "$ai_tool" > "$ai_tool_file"
+    fi
+  fi
+
+  _selected_project_action="$action"
+
+  case "$action" in
+    select-project|open-once)
+      local name path
+      name=$(echo "$result" | jq -r '.name' 2>/dev/null)
+      path=$(echo "$result" | jq -r '.path' 2>/dev/null)
+
+      if [[ -z "$name" || "$name" == "null" ]]; then
+        error "TUI returned invalid project name"
+        return 1
+      fi
+      if [[ -z "$path" || "$path" == "null" ]]; then
+        error "TUI returned invalid project path"
+        return 1
+      fi
+
+      _selected_project_name="$name"
+      _selected_project_path="$path"
+      return 0
+      ;;
+    quit)
+      return 1
+      ;;
+    add-worktree)
+      local wt_project_name wt_project_path
+      wt_project_name=$(echo "$result" | jq -r '.name' 2>/dev/null)
+      wt_project_path=$(echo "$result" | jq -r '.path' 2>/dev/null)
+
+      if [[ -z "$wt_project_path" || "$wt_project_path" == "null" ]]; then
+        error "TUI returned invalid project path for worktree"
+        _selected_project_action="add-worktree"
+        return 0
+      fi
+
+      # Launch branch picker
+      local branch_result
+      if ! branch_result=$(ghost-tab-tui select-branch --project-path "$wt_project_path" --ai-tool "${SELECTED_AI_TOOL:-claude}" 2>/dev/null); then
+        _selected_project_action="add-worktree"
+        return 0
+      fi
+
+      local branch_selected
+      branch_selected=$(echo "$branch_result" | jq -r '.selected' 2>/dev/null)
+      if [[ "$branch_selected" != "true" ]]; then
+        _selected_project_action="add-worktree"
+        return 0
+      fi
+
+      local branch
+      branch=$(echo "$branch_result" | jq -r '.branch' 2>/dev/null)
+
+      # Read worktree base from settings
+      local worktree_base=""
+      if [ -f "$settings_file" ]; then
+        worktree_base=$(grep '^worktree_base=' "$settings_file" 2>/dev/null | cut -d= -f2)
+      fi
+
+      # Compute worktree path
+      local wt_path
+      wt_path=$(compute_worktree_path "$wt_project_path" "$wt_project_name" "$branch" "$worktree_base")
+
+      # Create worktree
+      if git -C "$wt_project_path" worktree add "$wt_path" "$branch" 2>/dev/null; then
+        success "Created worktree at $wt_path"
+      else
+        error "Failed to create worktree for branch '$branch'"
+      fi
+
+      _selected_project_action="add-worktree"
+      return 0
+      ;;
+    *)
+      # Other actions (plain-terminal, settings)
+      return 0
+      ;;
+  esac
+}

package/lib/notification-setup.sh

@@ -0,0 +1,210 @@
+#!/bin/bash
+# Notification setup — sound hooks.
+# Depends on: tui.sh (success, warn)
+
+# Play notification sound if enabled for the given AI tool.
+# Reads sound preference from features JSON and plays via afplay in background.
+# Usage: play_notification_sound <ai_tool> <config_dir>
+play_notification_sound() {
+  local ai_tool="$1" config_dir="$2"
+  local sound_name
+  sound_name="$(get_sound_name "$ai_tool" "$config_dir")"
+  if [[ -n "$sound_name" ]]; then
+    afplay "/System/Library/Sounds/${sound_name}.aiff" &
+  fi
+}
+
+# Set up sound notification for the given AI tool.
+# Manages only the notification channel (to prevent double sounds).
+# Sound playback is handled by the tab-title-watcher.
+# Usage: setup_sound_notification <config_dir>
+setup_sound_notification() {
+  local config_dir="$1"
+  set_claude_notif_channel "$config_dir"
+}
+
+# Set Claude Code's preferredNotifChannel to terminal_bell to prevent
+# double sounds (ghost-tab hook + built-in notification).
+# Saves the previous value to <config_dir>/prev-notif-channel for restoration.
+# Usage: set_claude_notif_channel <config_dir>
+set_claude_notif_channel() {
+  local config_dir="$1"
+  if ! command -v claude &>/dev/null; then
+    return 0
+  fi
+  mkdir -p "$config_dir"
+  local prev
+  prev="$(CLAUDECODE="" claude config get preferredNotifChannel 2>/dev/null || true)"
+  echo "$prev" > "$config_dir/prev-notif-channel"
+  CLAUDECODE="" claude config set preferredNotifChannel terminal_bell 2>/dev/null || true
+}
+
+# Restore Claude Code's preferredNotifChannel from saved value.
+# If no saved value exists, does nothing.
+# Usage: restore_claude_notif_channel <config_dir>
+restore_claude_notif_channel() {
+  local config_dir="$1"
+  local saved_file="$config_dir/prev-notif-channel"
+  if [ ! -f "$saved_file" ]; then
+    return 0
+  fi
+  if ! command -v claude &>/dev/null; then
+    return 0
+  fi
+  local prev
+  prev="$(tr -d '[:space:]' < "$saved_file")"
+  if [[ -n "$prev" ]]; then
+    CLAUDECODE="" claude config set preferredNotifChannel "$prev" 2>/dev/null || true
+  else
+    CLAUDECODE="" claude config set preferredNotifChannel "" 2>/dev/null || true
+  fi
+  rm -f "$saved_file"
+}
+
+# Check if sound notifications are enabled for the given AI tool.
+# Usage: is_sound_enabled <tool> <config_dir>
+# Outputs "true" or "false".
+is_sound_enabled() {
+  local tool="$1" config_dir="$2"
+  local features_file="$config_dir/${tool}-features.json"
+  if [ -f "$features_file" ]; then
+    local val
+    val="$(python3 -c "
+import json, sys
+try:
+    d = json.load(open(sys.argv[1]))
+    print('false' if d.get('sound') is False else 'true')
+except Exception:
+    print('true')
+" "$features_file" 2>/dev/null)"
+    echo "${val:-true}"
+  else
+    echo "true"
+  fi
+}
+
+# Get the sound name for the given AI tool.
+# Returns the sound name (e.g. "Bottle") or empty string if sound is disabled.
+# Usage: get_sound_name <tool> <config_dir>
+get_sound_name() {
+  local tool="$1" config_dir="$2"
+  local features_file="$config_dir/${tool}-features.json"
+  if [ -f "$features_file" ]; then
+    python3 -c "
+import json, sys
+try:
+    d = json.load(open(sys.argv[1]))
+    if d.get('sound') is False:
+        print('')
+    else:
+        print(d.get('sound_name', 'Bottle'))
+except Exception:
+    print('Bottle')
+" "$features_file" 2>/dev/null
+  else
+    echo "Bottle"
+  fi
+}
+
+# Set the sound name for the given AI tool.
+# Usage: set_sound_name <tool> <config_dir> <name>
+set_sound_name() {
+  local tool="$1" config_dir="$2" name="$3"
+  local features_file="$config_dir/${tool}-features.json"
+  mkdir -p "$config_dir"
+  python3 -c "
+import json, sys
+path = sys.argv[1]
+name = sys.argv[2]
+try:
+    d = json.load(open(path))
+except Exception:
+    d = {}
+d['sound_name'] = name
+with open(path, 'w') as f:
+    json.dump(d, f)
+    f.write('\n')
+" "$features_file" "$name"
+}
+
+# Set sound feature flag for the given AI tool.
+# Usage: set_sound_feature_flag <tool> <config_dir> <true|false>
+set_sound_feature_flag() {
+  local tool="$1" config_dir="$2" enabled="$3"
+  local features_file="$config_dir/${tool}-features.json"
+  mkdir -p "$config_dir"
+  python3 -c "
+import json, sys, os
+path = sys.argv[1]
+enabled = sys.argv[2] == 'true'
+try:
+    d = json.load(open(path))
+except Exception:
+    d = {}
+d['sound'] = enabled
+with open(path, 'w') as f:
+    json.dump(d, f)
+    f.write('\n')
+" "$features_file" "$enabled"
+}
+
+# Remove sound notification setup for the given AI tool.
+# Restores the notification channel.
+# Usage: remove_sound_notification <config_dir>
+remove_sound_notification() {
+  local config_dir="$1"
+  restore_claude_notif_channel "$config_dir"
+}
+
+# Toggle sound notification for the given AI tool.
+# Usage: toggle_sound_notification <tool> <config_dir>
+# Reads current state, flips it, applies the change.
+toggle_sound_notification() {
+  local tool="$1" config_dir="$2"
+  local current
+  current="$(is_sound_enabled "$tool" "$config_dir")"
+
+  if [[ "$current" == "true" ]]; then
+    set_sound_feature_flag "$tool" "$config_dir" false
+    case "$tool" in
+      claude)
+        remove_sound_notification "$config_dir"
+        ;;
+    esac
+    success "Sound notifications disabled"
+  else
+    set_sound_feature_flag "$tool" "$config_dir" true
+    case "$tool" in
+      claude)
+        setup_sound_notification "$config_dir"
+        ;;
+    esac
+    success "Sound notifications enabled"
+  fi
+}
+
+# Apply sound notification state for the given AI tool.
+# Usage: apply_sound_notification <tool> <config_dir> <sound_name>
+# If sound_name is empty, disables sound. Otherwise enables with that sound.
+apply_sound_notification() {
+  local tool="$1" config_dir="$2" sound_name="$3"
+
+  if [[ -z "$sound_name" ]]; then
+    set_sound_feature_flag "$tool" "$config_dir" false
+    case "$tool" in
+      claude)
+        remove_sound_notification "$config_dir"
+        ;;
+    esac
+    success "Sound notifications disabled"
+  else
+    set_sound_feature_flag "$tool" "$config_dir" true
+    set_sound_name "$tool" "$config_dir" "$sound_name"
+    case "$tool" in
+      claude)
+        setup_sound_notification "$config_dir"
+        ;;
+    esac
+    success "Sound notifications enabled"
+  fi
+}

package/lib/process.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Process management helpers — no side effects on source.
+
+# Recursively kills a process tree (depth-first: children first, then parent).
+kill_tree() {
+  local pid=$1
+  local sig=${2:-TERM}
+  for child in $(pgrep -P "$pid" 2>/dev/null); do
+    kill_tree "$child" "$sig"
+  done
+  kill -"$sig" "$pid" 2>/dev/null
+  return 0
+}

package/lib/project-actions-tui.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Interactive TUI wrappers for project actions using ghost-tab-tui
+
+# Interactive project addition using ghost-tab-tui
+# Returns 0 if confirmed, 1 if cancelled
+# Sets: _add_project_name, _add_project_path
+add_project_interactive() {
+  if ! command -v ghost-tab-tui &>/dev/null; then
+    error "ghost-tab-tui binary not found. Please reinstall."
+    return 1
+  fi
+
+  local result
+  if ! result=$(ghost-tab-tui add-project 2>/dev/null); then
+    return 1
+  fi
+
+  local confirmed
+  confirmed=$(echo "$result" | jq -r '.confirmed')
+
+  if [[ "$confirmed" != "true" ]]; then
+    return 1
+  fi
+
+  _add_project_name=$(echo "$result" | jq -r '.name')
+  _add_project_path=$(echo "$result" | jq -r '.path')
+
+  return 0
+}

package/lib/project-actions.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+# Project file operations — add, delete, validate.
+
+# Append a project entry to the projects file (creates parent dirs).
+add_project_to_file() {
+  local name="$1" path="$2" projects_file="$3"
+  mkdir -p "$(dirname "$projects_file")"
+  echo "${name}:${path}" >> "$projects_file"
+}

package/lib/projects.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# Project file helpers — pure, no side effects on source.
+
+# Reads a projects file and outputs valid lines (skips blanks and comments).
+# Usage: mapfile -t projects < <(load_projects "$file")
+load_projects() {
+  local file="$1" line
+  [ ! -f "$file" ] && return
+  while IFS= read -r line; do
+    [[ -z "$line" || "$line" == \#* ]] && continue
+    echo "$line"
+  done < "$file"
+}
+
+# Expands ~ to $HOME at the start of a path.
+path_expand() {
+  echo "${1/#\~/$HOME}"
+}

package/lib/settings-json.sh

@@ -0,0 +1,178 @@
+#!/bin/bash
+# Claude settings.json manipulation helpers.
+
+# Merge statusLine into Claude settings.json (create if missing).
+merge_claude_settings() {
+  local path="$1"
+  mkdir -p "$(dirname "$path")"
+  if [ -f "$path" ]; then
+    if grep -q '"statusLine"' "$path"; then
+      success "Claude status line already configured"
+    else
+      sed -i '' '$ s/}$/,\n  "statusLine": {\n    "type": "command",\n    "command": "bash ~\/.claude\/statusline-wrapper.sh"\n  }\n}/' "$path"
+      success "Added status line to Claude settings"
+    fi
+  else
+    cat > "$path" << 'CSEOF'
+{
+  "statusLine": {
+    "type": "command",
+    "command": "bash ~/.claude/statusline-wrapper.sh"
+  }
+}
+CSEOF
+    success "Created Claude settings with status line"
+  fi
+}
+
+# Add waiting indicator hooks (Stop + PreToolUse + UserPromptSubmit) to settings.json.
+# Uses $GHOST_TAB_MARKER_FILE env var so hooks are safe outside Ghost Tab.
+# Outputs "added", "upgraded", or "exists".
+add_waiting_indicator_hooks() {
+  local path="$1"
+  mkdir -p "$(dirname "$path")"
+  python3 - "$path" << 'PYEOF'
+import json, sys, os
+
+settings_path = sys.argv[1]
+
+if os.path.exists(settings_path):
+    try:
+        with open(settings_path, "r") as f:
+            settings = json.load(f)
+    except (json.JSONDecodeError, ValueError):
+        settings = {}
+else:
+    settings = {}
+
+hooks = settings.setdefault("hooks", {})
+
+stop_cmd = 'if [ -n "$GHOST_TAB_MARKER_FILE" ]; then touch "$GHOST_TAB_MARKER_FILE"; fi'
+clear_cmd = 'if [ -n "$GHOST_TAB_MARKER_FILE" ]; then rm -f "$GHOST_TAB_MARKER_FILE"; fi'
+
+marker = "GHOST_TAB_MARKER_FILE"
+
+# Check if current Stop-based format is already installed
+stop_list = hooks.get("Stop", [])
+stop_exists = any(
+    marker in h.get("command", "")
+    for entry in stop_list
+    for h in entry.get("hooks", [])
+)
+
+# Check if old Notification-based format exists (needs upgrade)
+notif_list = hooks.get("Notification", [])
+notif_exists = any(
+    marker in h.get("command", "")
+    for entry in notif_list
+    for h in entry.get("hooks", [])
+)
+
+# Check if old Stop format without matcher exists (needs upgrade)
+pre_list = hooks.get("PreToolUse", [])
+old_stop_needs_upgrade = stop_exists and not any(
+    entry.get("matcher") == "AskUserQuestion"
+    for entry in pre_list
+    if any(marker in h.get("command", "") for h in entry.get("hooks", []))
+)
+
+if stop_exists and not old_stop_needs_upgrade:
+    # Current Stop format already installed
+    print("exists")
+    sys.exit(0)
+elif notif_exists or old_stop_needs_upgrade:
+    # Old format — remove ghost-tab hooks so they get re-added below
+    for event in ["Stop", "Notification", "PreToolUse", "UserPromptSubmit"]:
+        event_list = hooks.get(event, [])
+        new_list = [
+            entry for entry in event_list
+            if not any(marker in h.get("command", "") for h in entry.get("hooks", []))
+        ]
+        if new_list:
+            hooks[event] = new_list
+        elif event in hooks:
+            del hooks[event]
+    action = "upgraded"
+else:
+    action = "added"
+
+# Add Stop hook (fires immediately when Claude stops generating)
+hooks.setdefault("Stop", []).append({
+    "hooks": [{"type": "command", "command": stop_cmd}]
+})
+
+# Add PreToolUse hook with matcher for AskUserQuestion (creates marker — user input needed)
+hooks.setdefault("PreToolUse", []).append({
+    "matcher": "AskUserQuestion",
+    "hooks": [{"type": "command", "command": stop_cmd}]
+})
+
+# Add PreToolUse catch-all hook (clears marker — Claude is actively working)
+hooks.setdefault("PreToolUse", []).append({
+    "hooks": [{"type": "command", "command": clear_cmd}]
+})
+
+# Add UserPromptSubmit hook (clears marker when user answers)
+hooks.setdefault("UserPromptSubmit", []).append({
+    "hooks": [{"type": "command", "command": clear_cmd}]
+})
+
+with open(settings_path, "w") as f:
+    json.dump(settings, f, indent=2)
+    f.write("\n")
+
+print(action)
+PYEOF
+}
+
+# Remove waiting indicator hooks from settings.json.
+# Outputs "removed" or "not_found".
+remove_waiting_indicator_hooks() {
+  local path="$1"
+  if [ ! -f "$path" ]; then
+    echo "not_found"
+    return 0
+  fi
+  python3 - "$path" << 'PYEOF'
+import json, sys, os
+
+settings_path = sys.argv[1]
+marker = "GHOST_TAB_MARKER_FILE"
+
+try:
+    with open(settings_path, "r") as f:
+        settings = json.load(f)
+except (json.JSONDecodeError, ValueError, FileNotFoundError):
+    print("not_found")
+    sys.exit(0)
+
+hooks = settings.get("hooks", {})
+found = False
+
+for event in ["Stop", "Notification", "PreToolUse", "UserPromptSubmit"]:
+    event_list = hooks.get(event, [])
+    new_list = [
+        entry for entry in event_list
+        if not any(marker in h.get("command", "") for h in entry.get("hooks", []))
+    ]
+    if len(new_list) != len(event_list):
+        found = True
+        if new_list:
+            hooks[event] = new_list
+        else:
+            del hooks[event]
+
+if not found:
+    print("not_found")
+    sys.exit(0)
+
+if not hooks:
+    del settings["hooks"]
+
+with open(settings_path, "w") as f:
+    json.dump(settings, f, indent=2)
+    f.write("\n")
+
+print("removed")
+PYEOF
+}

package/lib/settings-menu-tui.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+# TUI wrapper for settings menu
+# Uses ghost-tab-tui settings-menu subcommand
+
+# Interactive settings menu using ghost-tab-tui
+# Returns action string (or empty if quit)
+settings_menu_interactive() {
+  if ! command -v ghost-tab-tui &>/dev/null; then
+    error "ghost-tab-tui binary not found. Please reinstall."
+    return 1
+  fi
+
+  local result
+  if ! result=$(ghost-tab-tui settings-menu 2>/dev/null); then
+    return 1
+  fi
+
+  local action
+  if ! action=$(echo "$result" | jq -r '.action' 2>/dev/null); then
+    error "Failed to parse settings menu response"
+    return 1
+  fi
+
+  # Validate null/empty (empty is OK for quit, but null is not)
+  if [[ "$action" == "null" ]]; then
+    error "TUI returned invalid action"
+    return 1
+  fi
+
+  echo "$action"
+  return 0
+}