ghost-tab 2.6.0

package/lib/setup.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+# Setup helper functions — pure, no side effects on source.
+
+# Determines the SHARE_DIR (where supporting files live).
+# Usage: resolve_share_dir "$SCRIPT_DIR" "$BREW_PREFIX"
+# When script is in $BREW_PREFIX/bin, returns $BREW_PREFIX/share/ghost-tab.
+# Otherwise, returns the parent of the script directory.
+resolve_share_dir() {
+  local script_dir="$1"
+  local brew_prefix="$2"
+  if [[ -n "$brew_prefix" && "$script_dir" == "$brew_prefix/bin" ]]; then
+    echo "$brew_prefix/share/ghost-tab"
+  else
+    (cd "$script_dir/.." && pwd)
+  fi
+}

package/lib/statusline-setup.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+# Statusline setup — install ccstatusline, copy configs and scripts.
+# Depends on: tui.sh (success, warn, info), settings-json.sh (merge_claude_settings)
+
+# Check whether npm is available. Extracted for testability.
+_has_npm() { command -v npm &>/dev/null; }
+
+# Install and configure the Claude Code status line.
+# Usage: setup_statusline <share_dir> <claude_settings_path> <home_dir>
+setup_statusline() {
+  local share_dir="$1" claude_settings_path="$2" home_dir="$3"
+
+  # Check for npm, install Node.js LTS if needed
+  if ! _has_npm; then
+    info "Installing Node.js LTS..."
+    if brew install node@22 &>/dev/null; then
+      export PATH="/opt/homebrew/opt/node@22/bin:$PATH"
+      success "Node.js LTS installed"
+    else
+      warn "Node.js installation failed — skipping status line setup"
+      return 0
+    fi
+  fi
+
+  if ! _has_npm; then
+    return 0
+  fi
+
+  # Install ccstatusline
+  if npm list -g ccstatusline &>/dev/null; then
+    success "ccstatusline already installed"
+  else
+    info "Installing ccstatusline..."
+    if npm install -g ccstatusline &>/dev/null; then
+      success "ccstatusline installed"
+    else
+      warn "Failed to install ccstatusline — skipping status line setup"
+      return 0
+    fi
+  fi
+
+  if npm list -g ccstatusline &>/dev/null; then
+    # Create ccstatusline config
+    mkdir -p "$home_dir/.config/ccstatusline"
+    cp "$share_dir/templates/ccstatusline-settings.json" "$home_dir/.config/ccstatusline/settings.json"
+    success "Created ccstatusline config"
+
+    # Create statusline scripts
+    mkdir -p "$home_dir/.claude"
+    cp "$share_dir/templates/statusline-command.sh" "$home_dir/.claude/statusline-command.sh"
+    cp "$share_dir/templates/statusline-wrapper.sh" "$home_dir/.claude/statusline-wrapper.sh"
+    cp "$share_dir/lib/statusline.sh" "$home_dir/.claude/statusline-helpers.sh"
+    chmod +x "$home_dir/.claude/statusline-command.sh"
+    chmod +x "$home_dir/.claude/statusline-wrapper.sh"
+    success "Created statusline scripts"
+
+    # Update Claude settings.json
+    merge_claude_settings "$claude_settings_path"
+  fi
+}

package/lib/statusline.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+# Statusline helper functions — pure, no side effects on source.
+
+# Returns total RSS in KB for a process and all its descendants.
+# Usage: get_tree_rss_kb 12345  =>  "92160"
+get_tree_rss_kb() {
+  local root_pid="$1"
+  local total=0
+  local queue=("$root_pid")
+
+  while [ ${#queue[@]} -gt 0 ]; do
+    local pid="${queue[0]}"
+    queue=("${queue[@]:1}")
+
+    local rss
+    rss=$(ps -o rss= -p "$pid" 2>/dev/null | tr -d ' ')
+    if [ -n "$rss" ] && [ "$rss" -gt 0 ] 2>/dev/null; then
+      total=$((total + rss))
+    fi
+
+    local children
+    children=$(pgrep -P "$pid" 2>/dev/null) || true
+    if [ -n "$children" ]; then
+      while IFS= read -r child; do
+        queue+=("$child")
+      done <<< "$children"
+    fi
+  done
+
+  echo "$total"
+}

package/lib/tab-title-watcher.sh

@@ -0,0 +1,118 @@
+#!/bin/bash
+# Tab title watcher — detects AI tool waiting state, updates terminal tab title.
+# Depends on: tui.sh (set_tab_title, set_tab_title_waiting)
+
+_TAB_TITLE_WATCHER_PID=""
+
+# Return the age of the marker file in seconds.
+# Usage: marker_age <file>
+# Outputs the number of seconds since the file was last modified.
+# Returns 1 if the file does not exist or stat fails.
+marker_age() {
+  local file="$1"
+  local now mtime
+  now=$(date +%s)
+  mtime=$(stat -f %m "$file" 2>/dev/null) || return 1
+  echo $(( now - mtime ))
+}
+
+# Check if the AI tool is waiting for user input.
+# Usage: check_ai_tool_state <ai_tool> <session_name> <tmux_cmd> <marker_file> <pane_index>
+# Outputs "waiting" or "active".
+check_ai_tool_state() {
+  local ai_tool="$1" session_name="$2" tmux_cmd="$3" marker_file="$4"
+  local pane_index="${5:-3}"
+
+  if [ "$ai_tool" = "claude" ]; then
+    # Claude uses marker-file-only detection.
+    # Stop hook creates the marker (Claude stopped generating).
+    # UserPromptSubmit hook removes it (user answered).
+    # PreToolUse hook also removes it (Claude is calling tools).
+    if [ -f "$marker_file" ]; then
+      echo "waiting"
+    else
+      echo "active"
+    fi
+  else
+    local content last_line
+    content=$("$tmux_cmd" capture-pane -t "$session_name:0.$pane_index" -p 2>/dev/null || true)
+    last_line=$(echo "$content" | grep -v '^$' | tail -1)
+    if echo "$last_line" | grep -qE '[>$❯]\s*$'; then
+      echo "waiting"
+    else
+      echo "active"
+    fi
+  fi
+}
+
+# Discover the AI tool pane (rightmost pane in the tmux session).
+# Usage: discover_ai_pane <session_name> <tmux_cmd>
+# Outputs the pane index of the rightmost pane.
+discover_ai_pane() {
+  local session_name="$1" tmux_cmd="$2"
+  "$tmux_cmd" list-panes -t "$session_name" -F '#{pane_index} #{pane_left}' 2>/dev/null \
+    | sort -k2 -rn | head -1 | awk '{print $1}'
+}
+
+# Start the tab title watcher background loop.
+# Usage: start_tab_title_watcher <session_name> <ai_tool> <project_name> <tab_title_setting> <tmux_cmd> <marker_file> [config_dir]
+start_tab_title_watcher() {
+  local session_name="$1" ai_tool="$2" project_name="$3"
+  local tab_title_setting="$4" tmux_cmd="$5" marker_file="$6"
+  local config_dir="${7:-}"
+
+  (
+    # Find the AI tool pane (rightmost pane in the layout)
+    local ai_pane=""
+    while [ -z "$ai_pane" ]; do
+      ai_pane=$(discover_ai_pane "$session_name" "$tmux_cmd")
+      [ -z "$ai_pane" ] && sleep 0.5
+    done
+
+    local was_waiting=false
+    while true; do
+      sleep 0.5
+      local state
+      state=$(check_ai_tool_state "$ai_tool" "$session_name" "$tmux_cmd" "$marker_file" "$ai_pane")
+
+      if [ "$state" = "waiting" ] && [ "$was_waiting" = false ]; then
+        # Debounce: only notify if marker has existed for >= 1 second.
+        # Subagent completions create/remove markers within milliseconds,
+        # so they never reach the 1s threshold.
+        local age
+        age=$(marker_age "$marker_file") || continue
+        if [ "$age" -ge 1 ]; then
+          if [ "$tab_title_setting" = "full" ]; then
+            set_tab_title_waiting "$project_name" "$ai_tool"
+          else
+            set_tab_title_waiting "$project_name"
+          fi
+          if [[ -n "$config_dir" ]]; then
+            play_notification_sound "$ai_tool" "$config_dir"
+          fi
+          was_waiting=true
+        fi
+      elif [ "$state" = "active" ] && [ "$was_waiting" = true ]; then
+        if [ "$tab_title_setting" = "full" ]; then
+          set_tab_title "$project_name" "$ai_tool"
+        else
+          set_tab_title "$project_name"
+        fi
+        was_waiting=false
+      fi
+    done
+  ) &
+  _TAB_TITLE_WATCHER_PID=$!
+}
+
+# Stop the tab title watcher and clean up.
+# Usage: stop_tab_title_watcher [marker_file]
+stop_tab_title_watcher() {
+  local marker_file="${1:-}"
+  if [ -n "$_TAB_TITLE_WATCHER_PID" ]; then
+    kill "$_TAB_TITLE_WATCHER_PID" 2>/dev/null || true
+  fi
+  if [ -n "$marker_file" ]; then
+    rm -f "$marker_file"
+  fi
+}

package/lib/terminal-select-tui.sh

@@ -0,0 +1,119 @@
+#!/bin/bash
+# Terminal selection TUI wrapper using ghost-tab-tui
+
+# Interactive terminal selection.
+# Returns 0 if selected, 1 if cancelled.
+# Sets: _selected_terminal
+#
+# If GHOST_TAB_TERMINAL_PREF is set, reads current terminal from that file
+# and passes it to the TUI via --current flag.
+select_terminal_interactive() {
+  if ! command -v ghost-tab-tui &>/dev/null; then
+    error "ghost-tab-tui binary not found. Please reinstall."
+    return 1
+  fi
+
+  local _tui_stderr
+  _tui_stderr="$(mktemp 2>/dev/null || echo "/tmp/ghost-tab-tui-err.$$")"
+
+  while true; do
+    # Build command args
+    local args=("select-terminal")
+    if [[ -n "$GHOST_TAB_TERMINAL_PREF" && -f "$GHOST_TAB_TERMINAL_PREF" ]]; then
+      local current
+      current="$(tr -d '[:space:]' < "$GHOST_TAB_TERMINAL_PREF")"
+      if [[ -n "$current" ]]; then
+        args+=("--current" "$current")
+      fi
+    fi
+
+    local result
+    # Capture output regardless of exit code — bubbletea may exit non-zero
+    # during cleanup even when the user completed an action successfully.
+    # Capture stderr to a temp file so we can show it on failure.
+    result=$(ghost-tab-tui "${args[@]}" 2>"$_tui_stderr") || true
+
+    # If no output at all, the TUI failed to run
+    if [[ -z "$result" ]]; then
+      local tui_err=""
+      if [[ -f "$_tui_stderr" ]]; then
+        tui_err="$(cat "$_tui_stderr")"
+      fi
+      if [[ -n "$tui_err" ]]; then
+        error "Terminal selector failed: $tui_err"
+      else
+        error "Terminal selector failed to produce output. Try running: ghost-tab-tui select-terminal"
+      fi
+      rm -f "$_tui_stderr"
+      return 1
+    fi
+
+    local selected
+    if ! selected=$(echo "$result" | jq -r '.selected' 2>/dev/null); then
+      error "Failed to parse terminal selection response"
+      rm -f "$_tui_stderr"
+      return 1
+    fi
+
+    # Check for install action — run brew then loop back to TUI
+    local action
+    action=$(echo "$result" | jq -r '.action // empty' 2>/dev/null)
+    if [[ "$action" == "install" ]]; then
+      local cask terminal
+      cask=$(echo "$result" | jq -r '.cask // empty' 2>/dev/null)
+      terminal=$(echo "$result" | jq -r '.terminal // empty' 2>/dev/null)
+      # Fall back to terminal name if cask field is missing
+      if [[ -z "$cask" ]]; then
+        cask="$terminal"
+      fi
+      if [[ -n "$cask" && "$cask" != "null" ]]; then
+        echo ""
+        info "Installing $cask via Homebrew..."
+        if brew install --cask "$cask"; then
+          success "Installed $cask"
+          echo ""
+          # Auto-select the just-installed terminal
+          _selected_terminal="$terminal"
+          rm -f "$_tui_stderr"
+          return 0
+        else
+          error "Failed to install $cask"
+        fi
+        echo ""
+      fi
+      continue
+    fi
+
+    # User cancelled (or TUI failed and fell back to selected:false)
+    if [[ -z "$selected" || "$selected" == "null" || "$selected" != "true" ]]; then
+      # If stderr has content, the TUI likely failed — show the error
+      local tui_err=""
+      if [[ -f "$_tui_stderr" ]]; then
+        tui_err="$(cat "$_tui_stderr")"
+      fi
+      if [[ -n "$tui_err" ]]; then
+        error "Terminal selector failed: $tui_err"
+      fi
+      rm -f "$_tui_stderr"
+      return 1
+    fi
+
+    # User selected an installed terminal
+    local terminal
+    if ! terminal=$(echo "$result" | jq -r '.terminal' 2>/dev/null); then
+      error "Failed to parse selected terminal"
+      rm -f "$_tui_stderr"
+      return 1
+    fi
+
+    if [[ -z "$terminal" || "$terminal" == "null" ]]; then
+      error "TUI returned empty terminal selection"
+      rm -f "$_tui_stderr"
+      return 1
+    fi
+
+    _selected_terminal="$terminal"
+    rm -f "$_tui_stderr"
+    return 0
+  done
+}

package/lib/terminals/adapter.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# Terminal adapter loader — sources the correct adapter for a terminal.
+
+# Load the adapter for the given terminal identifier.
+# After calling this, terminal_setup_config, terminal_get_config_path, etc. are available.
+load_terminal_adapter() {
+  local terminal="$1"
+  local adapter_dir
+  adapter_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+  local adapter_file="$adapter_dir/${terminal}.sh"
+  if [ ! -f "$adapter_file" ]; then
+    error "Unknown terminal: $terminal"
+    return 1
+  fi
+
+  # shellcheck disable=SC1090  # Dynamic adapter loading
+  source "$adapter_file"
+}

package/lib/terminals/ghostty.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# Ghostty terminal adapter.
+
+# Return the path to Ghostty's config file.
+terminal_get_config_path() {
+  echo "$HOME/.config/ghostty/config"
+}
+
+# Return the path where the wrapper script should be.
+terminal_get_wrapper_path() {
+  echo "$HOME/.config/ghost-tab/wrapper.sh"
+}
+
+# Install Ghostty: check for the app, open download page if missing.
+terminal_install() {
+  local app_path="${GHOSTTY_APP_PATH:-/Applications/Ghostty.app}"
+  if [ -d "$app_path" ]; then
+    success "Ghostty found"
+    return 0
+  fi
+
+  info "Ghostty not found. Opening download page..."
+  open "https://ghostty.org/download"
+  echo ""
+  echo "  Download and install Ghostty from the page that just opened."
+  echo "  Press Enter when installation is complete."
+  read -r < /dev/tty
+
+  if [ ! -d "$app_path" ]; then
+    error "Ghostty still not found at $app_path"
+    info "Install Ghostty and re-run: ghost-tab --terminal"
+    return 1
+  fi
+  success "Ghostty installed"
+}
+
+# Write or merge the wrapper command into Ghostty config.
+# Args: config_path wrapper_path
+terminal_setup_config() {
+  local config_path="$1" wrapper_path="$2"
+  local wrapper_line="command = $wrapper_path"
+
+  if [ -f "$config_path" ] && grep -q '^command[[:space:]]*=' "$config_path"; then
+    sed -i '' 's|^command[[:space:]]*=.*|'"$wrapper_line"'|' "$config_path"
+    success "Replaced existing command line in config"
+  else
+    echo "$wrapper_line" >> "$config_path"
+    success "Appended wrapper command to config"
+  fi
+}
+
+# Remove ghost-tab command line from Ghostty config.
+terminal_cleanup_config() {
+  local config_path="$1"
+  if [ -f "$config_path" ]; then
+    sed -i '' '/^command[[:space:]]*=/d' "$config_path"
+  fi
+}

package/lib/terminals/iterm2.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+# iTerm2 terminal adapter using Dynamic Profiles.
+
+# Return the path to the Ghost Tab dynamic profile.
+terminal_get_config_path() {
+  echo "$HOME/Library/Application Support/iTerm2/DynamicProfiles/ghost-tab.json"
+}
+
+# Return the path where the wrapper script should be.
+terminal_get_wrapper_path() {
+  echo "$HOME/.config/ghost-tab/wrapper.sh"
+}
+
+# Install iTerm2 via Homebrew cask.
+terminal_install() {
+  ensure_cask "iterm2" "iTerm"
+}
+
+# Create a "Ghost Tab" dynamic profile for iTerm2.
+# Args: profile_path wrapper_path
+terminal_setup_config() {
+  local profile_path="$1" wrapper_path="$2"
+
+  mkdir -p "$(dirname "$profile_path")"
+
+  cat > "$profile_path" << EOF
+{
+  "Profiles": [
+    {
+      "Name": "Ghost Tab",
+      "Guid": "ghost-tab-profile",
+      "Custom Command": "Yes",
+      "Command": "$wrapper_path"
+    }
+  ]
+}
+EOF
+
+  success "Created Ghost Tab profile in iTerm2"
+  info "Set 'Ghost Tab' as your default profile in iTerm2 Preferences → Profiles"
+}
+
+# Remove the Ghost Tab dynamic profile from iTerm2.
+terminal_cleanup_config() {
+  local profile_path="$1"
+
+  if [ -f "$profile_path" ]; then
+    rm -f "$profile_path"
+    success "Removed Ghost Tab profile from iTerm2"
+  fi
+}

package/lib/terminals/kitty.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+# kitty terminal adapter.
+
+# Return the path to kitty's config file.
+terminal_get_config_path() {
+  echo "$HOME/.config/kitty/kitty.conf"
+}
+
+# Return the path where the wrapper script should be.
+terminal_get_wrapper_path() {
+  echo "$HOME/.config/ghost-tab/wrapper.sh"
+}
+
+# Install kitty via Homebrew cask.
+terminal_install() {
+  ensure_cask "kitty" "kitty"
+}
+
+# Write or merge the wrapper command into kitty config.
+# Args: config_path wrapper_path
+terminal_setup_config() {
+  local config_path="$1" wrapper_path="$2"
+  local shell_line="shell $wrapper_path"
+
+  if [ -f "$config_path" ] && grep -q '^shell[[:space:]]' "$config_path"; then
+    sed -i '' 's|^shell[[:space:]].*|'"$shell_line"'|' "$config_path"
+    success "Replaced existing shell line in config"
+  else
+    echo "$shell_line" >> "$config_path"
+    success "Appended wrapper command to config"
+  fi
+}
+
+# Remove ghost-tab shell line from kitty config.
+terminal_cleanup_config() {
+  local config_path="$1"
+  if [ -f "$config_path" ]; then
+    sed -i '' '/^shell[[:space:]]/d' "$config_path"
+  fi
+}

package/lib/terminals/registry.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# Terminal registry — lists supported terminals and manages preference.
+
+# Print supported terminal identifiers, one per line.
+get_supported_terminals() {
+  echo "ghostty"
+  echo "iterm2"
+  echo "wezterm"
+  echo "kitty"
+}
+
+# Return the human-readable display name for a terminal identifier.
+get_terminal_display_name() {
+  local terminal="$1"
+  case "$terminal" in
+    ghostty) echo "Ghostty" ;;
+    iterm2)  echo "iTerm2" ;;
+    wezterm) echo "WezTerm" ;;
+    kitty)   echo "kitty" ;;
+    *)       echo "$terminal" ;;
+  esac
+}
+
+# Read saved terminal preference from file. Prints the terminal name or empty.
+load_terminal_preference() {
+  local pref_file="$1"
+  if [ -f "$pref_file" ]; then
+    tr -d '[:space:]' < "$pref_file"
+  fi
+}
+
+# Save terminal preference to file.
+save_terminal_preference() {
+  local terminal="$1" pref_file="$2"
+  mkdir -p "$(dirname "$pref_file")"
+  echo "$terminal" > "$pref_file"
+}

package/lib/terminals/wezterm.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+# WezTerm terminal adapter.
+
+# Return the path to WezTerm's config file.
+terminal_get_config_path() {
+  echo "$HOME/.wezterm.lua"
+}
+
+# Return the path where the wrapper script should be.
+terminal_get_wrapper_path() {
+  echo "$HOME/.config/ghost-tab/wrapper.sh"
+}
+
+# Install WezTerm via Homebrew cask.
+terminal_install() {
+  ensure_cask "wezterm" "WezTerm"
+}
+
+# Write or merge the wrapper command into WezTerm Lua config.
+# Args: config_path wrapper_path
+terminal_setup_config() {
+  local config_path="$1" wrapper_path="$2"
+
+  if [ -f "$config_path" ] && grep -q 'default_prog' "$config_path"; then
+    # Replace existing default_prog line
+    sed -i '' "s|config\.default_prog[[:space:]]*=.*|config.default_prog = { '$wrapper_path' }|" "$config_path"
+    success "Replaced existing default_prog in WezTerm config"
+  elif [ -f "$config_path" ]; then
+    # Insert before 'return config'
+    sed -i '' "s|return config|config.default_prog = { '$wrapper_path' }\nreturn config|" "$config_path"
+    success "Added default_prog to WezTerm config"
+  else
+    # Create minimal config
+    cat > "$config_path" << EOF
+local wezterm = require 'wezterm'
+local config = wezterm.config_builder()
+config.default_prog = { '$wrapper_path' }
+return config
+EOF
+    success "Created WezTerm config with wrapper"
+  fi
+}
+
+# Remove ghost-tab default_prog from WezTerm config.
+terminal_cleanup_config() {
+  local config_path="$1"
+  if [ -f "$config_path" ]; then
+    sed -i '' '/default_prog/d' "$config_path"
+  fi
+}

package/lib/tmux-session.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# Tmux session helpers — build launch command, cleanup.
+# Depends on: process.sh (kill_tree)
+
+# Build the AI tool launch command string.
+# Usage: build_ai_launch_cmd <tool> <claude_cmd> <codex_cmd> <copilot_cmd> <opencode_cmd> [extra_args_or_project_dir]
+build_ai_launch_cmd() {
+  local tool="$1" claude_cmd="$2" codex_cmd="$3" copilot_cmd="$4" opencode_cmd="$5"
+  shift 5
+  local extra="$*"
+
+  case "$tool" in
+    codex)
+      echo "$codex_cmd --cd \"$extra\""
+      ;;
+    copilot)
+      echo "$copilot_cmd"
+      ;;
+    opencode)
+      echo "$opencode_cmd \"$extra\""
+      ;;
+    *)
+      if [ -n "$extra" ]; then
+        echo "$claude_cmd $extra"
+      else
+        echo "$claude_cmd"
+      fi
+      ;;
+  esac
+}
+
+# Clean up a tmux session: kill watcher, TERM pane trees, KILL survivors, destroy session.
+cleanup_tmux_session() {
+  local session_name="$1" watcher_pid="$2" tmux_cmd="$3"
+
+  kill "$watcher_pid" 2>/dev/null || true
+
+  local pane_pid
+  for pane_pid in $("$tmux_cmd" list-panes -s -t "$session_name" -F '#{pane_pid}' 2>/dev/null); do
+    kill_tree "$pane_pid" TERM
+  done
+
+  sleep 0.3
+  for pane_pid in $("$tmux_cmd" list-panes -s -t "$session_name" -F '#{pane_pid}' 2>/dev/null); do
+    kill_tree "$pane_pid" KILL
+  done
+
+  "$tmux_cmd" kill-session -t "$session_name" 2>/dev/null || true
+}