ghost-tab 2.6.0

package/lib/tui.sh

@@ -0,0 +1,80 @@
+#!/bin/bash
+# Shared TUI helpers — colors, logging, cursor utilities.
+
+# Basic colors (with terminal capability fallback)
+if [ -t 1 ] && [ "$(tput colors 2>/dev/null)" -ge 8 ] 2>/dev/null; then
+  _GREEN='\033[0;32m'
+  _YELLOW='\033[0;33m'
+  _RED='\033[0;31m'
+  _BLUE='\033[0;34m'
+  _BOLD='\033[1m'
+  _NC='\033[0m'
+else
+  _GREEN='' _YELLOW='' _RED='' _BLUE='' _BOLD='' _NC=''
+fi
+
+# Logging helpers
+success() { echo -e "${_GREEN}✓${_NC} $1"; }
+warn()    { echo -e "${_YELLOW}!${_NC} $1"; }
+error()   { echo -e "${_RED}✗${_NC} $1"; }
+info()    { echo -e "${_BLUE}→${_NC} $1"; }
+header()  { echo -e "\n${_BOLD}$1${_NC}"; }
+
+# Set terminal/tab title. With tool: "project · tool", without: "project"
+set_tab_title() {
+  local project="$1"
+  local tool="${2:-}"
+  if [ -n "$tool" ]; then
+    printf '\033]0;%s · %s\007' "$project" "$tool"
+  else
+    printf '\033]0;%s\007' "$project"
+  fi
+}
+
+# Set terminal/tab title with ● prefix (waiting state).
+# Same format as set_tab_title but prepends "● ".
+set_tab_title_waiting() {
+  local project="$1"
+  local tool="${2:-}"
+  if [ -n "$tool" ]; then
+    printf '\033]0;● %s · %s\007' "$project" "$tool"
+  else
+    printf '\033]0;● %s\007' "$project"
+  fi
+}
+
+# Extended TUI variables for interactive full-screen UIs.
+# Call this before using any of the extended variables.
+tui_init_interactive() {
+  _CYAN=$'\033[0;36m'
+  _DIM=$'\033[2m'
+  _INVERSE=$'\033[7m'
+  _BG_BLUE=$'\033[48;5;27m'
+  _BG_RED=$'\033[48;5;160m'
+  _WHITE=$'\033[1;37m'
+  _HIDE_CURSOR=$'\033[?25l'
+  _SHOW_CURSOR=$'\033[?25h'
+  _MOUSE_ON=$'\033[?1000h\033[?1006h'
+  _MOUSE_OFF=$'\033[?1000l\033[?1006l'
+}
+
+# Move cursor to row;col
+moveto() { printf '\033[%d;%dH' "$1" "$2"; }
+
+# Print N spaces
+pad() { printf "%*s" "$1" ""; }
+
+# Draw logo using ghost-tab-tui binary
+# Usage: draw_logo tool_name [row] [col]
+# If row/col provided, they are ignored (for compatibility)
+draw_logo() {
+  # shellcheck disable=SC2034  # tool parameter reserved for future use
+  local tool="$1"
+
+  if command -v ghost-tab-tui &>/dev/null; then
+    ghost-tab-tui show-logo 2>/dev/null || true
+  else
+    # Fallback: no logo if binary missing
+    return 0
+  fi
+}

package/lib/update.sh

@@ -0,0 +1,52 @@
+#!/bin/bash
+# Git-based auto-update for ghost-tab.
+
+# Show update notification if a previous background update wrote a flag file.
+# Deletes the flag after displaying.
+notify_if_updated() {
+  local config_home="${XDG_CONFIG_HOME:-$HOME/.config}"
+  local flag="${config_home}/ghost-tab/updated"
+  [ -f "$flag" ] || return 0
+
+  local version
+  version="$(cat "$flag")"
+  rm -f "$flag"
+  echo "  ↑ Updated to v${version}"
+}
+
+# Run a background git fetch + pull in share_dir.
+# If a new version is pulled, downloads the ghost-tab-tui binary and writes a flag file.
+# Args: share_dir
+check_for_update() {
+  local share_dir="$1"
+  local config_home="${XDG_CONFIG_HOME:-$HOME/.config}"
+  local flag="${config_home}/ghost-tab/updated"
+
+  # Only works if share_dir is a git repo
+  [ -d "$share_dir/.git" ] || return 0
+
+  (
+    local local_ref remote_ref
+    git -C "$share_dir" fetch origin main --quiet 2>/dev/null || return
+
+    local_ref="$(git -C "$share_dir" rev-parse HEAD 2>/dev/null)"
+    remote_ref="$(git -C "$share_dir" rev-parse origin/main 2>/dev/null)"
+    [ "$local_ref" = "$remote_ref" ] && return
+
+    git -C "$share_dir" pull --rebase --quiet origin main 2>/dev/null || return
+
+    local new_version arch
+    new_version="$(tr -d '[:space:]' < "$share_dir/VERSION" 2>/dev/null)" || return
+    [ -n "$new_version" ] || return
+
+    arch="$(uname -m)"
+    local bin_url="https://github.com/JackUait/ghost-tab/releases/download/v${new_version}/ghost-tab-tui-darwin-${arch}"
+    mkdir -p "$HOME/.local/bin"
+    curl -fsSL -o "$HOME/.local/bin/ghost-tab-tui" "$bin_url" 2>/dev/null && \
+      chmod +x "$HOME/.local/bin/ghost-tab-tui" || true
+
+    mkdir -p "${config_home}/ghost-tab"
+    echo "$new_version" > "$flag"
+  ) &
+  disown
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "ghost-tab",
+  "version": "2.6.0",
+  "description": "Terminal + tmux wrapper for AI coding tools (Claude Code, Codex CLI, Copilot CLI, OpenCode)",
+  "bin": {
+    "ghost-tab": "bin/npx-ghost-tab.js"
+  },
+  "files": [
+    "bin/ghost-tab",
+    "bin/npx-ghost-tab.js",
+    "lib/",
+    "templates/",
+    "ghostty/",
+    "terminals/",
+    "wrapper.sh",
+    "VERSION"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "keywords": [
+    "ghost-tab",
+    "tmux",
+    "terminal",
+    "claude",
+    "codex",
+    "copilot",
+    "opencode",
+    "ai",
+    "coding"
+  ],
+  "author": "JackUait",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JackUait/ghost-tab.git"
+  },
+  "homepage": "https://github.com/JackUait/ghost-tab",
+  "engines": {
+    "node": ">=16"
+  }
+}

package/templates/ccstatusline-settings.json

@@ -0,0 +1,29 @@
+{
+  "version": 3,
+  "lines": [
+    [
+      {
+        "id": "1",
+        "type": "context-percentage",
+        "color": "yellow",
+        "bold": true,
+        "rawValue": true
+      }
+    ],
+    [],
+    []
+  ],
+  "flexMode": "full-minus-40",
+  "compactThreshold": 60,
+  "colorLevel": 2,
+  "inheritSeparatorColors": false,
+  "globalBold": false,
+  "powerline": {
+    "enabled": false,
+    "separators": [""],
+    "separatorInvertBackground": [false],
+    "startCaps": [],
+    "endCaps": [],
+    "autoAlign": false
+  }
+}

package/templates/statusline-command.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+input=$(cat)
+cwd=$(echo "$input" | sed -n 's/.*"current_dir":"\([^"]*\)".*/\1/p')
+
+if git -C "$cwd" rev-parse --git-dir > /dev/null 2>&1; then
+  repo_name=$(basename "$cwd")
+  branch=$(git -C "$cwd" --no-optional-locks rev-parse --abbrev-ref HEAD 2>/dev/null)
+
+  # Session line diff: compare working tree against baseline SHA
+  baseline_file="${GHOST_TAB_BASELINE_FILE:-}"
+  if [ -n "$baseline_file" ] && [ -f "$baseline_file" ]; then
+    baseline_sha=$(head -1 "$baseline_file" 2>/dev/null)
+    if [ -n "$baseline_sha" ]; then
+      diff_stats=$(git -C "$cwd" --no-optional-locks diff "$baseline_sha" --numstat 2>/dev/null \
+        | awk '{a+=$1; d+=$2} END {print a+0, d+0}')
+      added=$(echo "$diff_stats" | cut -d' ' -f1)
+      deleted=$(echo "$diff_stats" | cut -d' ' -f2)
+    fi
+  fi
+
+  if [ -n "${added:-}" ]; then
+    printf '\033[01;36m%s\033[00m | \033[01;32m%s\033[00m | \033[01;32m+%s\033[00m / \033[01;31m-%s\033[00m' \
+      "$repo_name" "$branch" "$added" "$deleted"
+  else
+    printf '\033[01;36m%s\033[00m | \033[01;32m%s\033[00m' \
+      "$repo_name" "$branch"
+  fi
+else
+  printf '\033[01;36m%s\033[00m' "$(basename "$cwd")"
+fi

package/templates/statusline-wrapper.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+# shellcheck source=../lib/statusline.sh
+source "$(dirname "$0")/../lib/statusline.sh" 2>/dev/null \
+  || source ~/.claude/statusline-helpers.sh 2>/dev/null \
+  || true
+
+input=$(cat)
+git_info=$(echo "$input" | bash ~/.claude/statusline-command.sh)
+context_pct=$(echo "$input" | npx ccstatusline 2>/dev/null)
+
+# Find parent Claude Code process and get total tree memory usage
+pid=$PPID
+mem_label=""
+while [ -n "$pid" ] && [ "$pid" != "1" ]; do
+  comm=$(ps -o comm= -p "$pid" 2>/dev/null | xargs basename 2>/dev/null)
+  if [ "$comm" = "claude" ]; then
+    if type get_tree_rss_kb &>/dev/null; then
+      mem_kb=$(get_tree_rss_kb "$pid")
+    else
+      mem_kb=$(ps -o rss= -p "$pid" 2>/dev/null | tr -d ' ')
+    fi
+    if [ -n "$mem_kb" ] && [ "$mem_kb" -gt 0 ] 2>/dev/null; then
+      mem_mb=$((mem_kb / 1024))
+      if [ "$mem_mb" -ge 1024 ]; then
+        mem_gb=$(echo "scale=1; $mem_mb / 1024" | bc)
+        mem_label="${mem_gb}G"
+      else
+        mem_label="${mem_mb}M"
+      fi
+    fi
+    break
+  fi
+  pid=$(ps -o ppid= -p "$pid" 2>/dev/null | tr -d ' ')
+done
+
+if [ -n "$mem_label" ]; then
+  printf '%s | %s | \033[01;35m%s\033[00m' "$git_info" "$context_pct" "$mem_label"
+else
+  printf '%s | %s' "$git_info" "$context_pct"
+fi

package/terminals/ghostty/config

@@ -0,0 +1,5 @@
+keybind = cmd+shift+left=previous_tab
+keybind = cmd+shift+right=next_tab
+keybind = cmd+t=new_tab
+macos-option-as-alt = left
+command = ~/.config/ghost-tab/wrapper.sh

package/terminals/kitty/config

@@ -0,0 +1 @@
+shell ~/.config/ghost-tab/wrapper.sh

package/terminals/wezterm/config.lua

@@ -0,0 +1,4 @@
+local wezterm = require 'wezterm'
+local config = wezterm.config_builder()
+config.default_prog = { '~/.config/ghost-tab/wrapper.sh' }
+return config

package/wrapper.sh

@@ -0,0 +1,222 @@
+#!/bin/bash
+export PATH="$HOME/.local/bin:/opt/homebrew/bin:/usr/local/bin:$PATH"
+
+SHARE_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab"
+
+# shellcheck source=/dev/null
+[ -f "$SHARE_DIR/lib/update.sh" ] && source "$SHARE_DIR/lib/update.sh"
+
+notify_if_updated
+check_for_update "$SHARE_DIR"
+
+# Show animated loading screen immediately in interactive mode (no args)
+_wrapper_dir_early="$(cd "$(dirname "$0")" && pwd)"
+if [ -z "$1" ] && [ -f "$_wrapper_dir_early/lib/loading.sh" ]; then
+  # shellcheck disable=SC1091  # Dynamic path
+  source "$_wrapper_dir_early/lib/loading.sh"
+  # Mirrors AI_TOOL_PREF_FILE (defined after libs load); duplicated here because loading.sh runs before modules
+  _ai_tool="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab/ai-tool" 2>/dev/null | tr -d '[:space:]')"
+  show_loading_screen "${_ai_tool:-}"
+fi
+
+# Check if ghost-tab-tui binary is available
+if ! command -v ghost-tab-tui &>/dev/null; then
+  printf '\033[31mError:\033[0m ghost-tab-tui binary not found.\n' >&2
+  printf 'Run \033[1mghost-tab\033[0m to reinstall.\n' >&2
+  printf 'Press any key to exit...\n' >&2
+  read -rsn1
+  exit 1
+fi
+
+# Load shared library functions
+_WRAPPER_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+if [ ! -d "$_WRAPPER_DIR/lib" ]; then
+  printf '\033[31mError:\033[0m Ghost Tab libraries not found at %s/lib\n' "$_WRAPPER_DIR" >&2
+  printf 'Run \033[1mghost-tab\033[0m to reinstall.\n' >&2
+  printf 'Press any key to exit...\n' >&2
+  read -rsn1
+  exit 1
+fi
+
+_gt_libs=(ai-tools projects process input tui menu-tui project-actions project-actions-tui tmux-session settings-menu-tui settings-json notification-setup tab-title-watcher)
+for _gt_lib in "${_gt_libs[@]}"; do
+  if [ ! -f "$_WRAPPER_DIR/lib/${_gt_lib}.sh" ]; then
+    printf '\033[31mError:\033[0m Missing library %s/lib/%s.sh\n' "$_WRAPPER_DIR" "$_gt_lib" >&2
+    printf 'Run \033[1mghost-tab\033[0m to reinstall.\n' >&2
+    printf 'Press any key to exit...\n' >&2
+    read -rsn1
+    exit 1
+  fi
+  # shellcheck disable=SC1090  # Dynamic module loading
+  source "$_WRAPPER_DIR/lib/${_gt_lib}.sh"
+done
+unset _gt_libs _gt_lib
+
+TMUX_CMD="$(command -v tmux)"
+LAZYGIT_CMD="$(command -v lazygit)"
+BROOT_CMD="$(command -v broot)"
+CLAUDE_CMD="$(command -v claude)"
+CODEX_CMD="$(command -v codex)"
+COPILOT_CMD="$(command -v copilot)"
+OPENCODE_CMD="$(command -v opencode)"
+
+# AI tool preference
+AI_TOOL_PREF_FILE="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab/ai-tool"
+AI_TOOLS_AVAILABLE=()
+[ -n "$CLAUDE_CMD" ] && AI_TOOLS_AVAILABLE+=("claude")
+[ -n "$CODEX_CMD" ] && AI_TOOLS_AVAILABLE+=("codex")
+[ -n "$COPILOT_CMD" ] && AI_TOOLS_AVAILABLE+=("copilot")
+[ -n "$OPENCODE_CMD" ] && AI_TOOLS_AVAILABLE+=("opencode")
+
+# Read saved preference, default to first available
+SELECTED_AI_TOOL=""
+if [ -f "$AI_TOOL_PREF_FILE" ]; then
+  SELECTED_AI_TOOL="$(cat "$AI_TOOL_PREF_FILE" 2>/dev/null | tr -d '[:space:]')"
+fi
+# Validate saved preference is still installed
+validate_ai_tool "$AI_TOOL_PREF_FILE"
+
+# Load user projects from config file if it exists
+PROJECTS_FILE="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab/projects"
+
+# Select working directory
+if [ -n "$1" ] && [ -d "$1" ]; then
+  cd "$1" || exit 1
+  shift
+elif [ -z "$1" ]; then
+  # Use TUI for project selection
+  printf '\033]0;👻 Ghost Tab\007'
+
+  # Stop loading animation before TUI takes over
+  type stop_loading_screen &>/dev/null && stop_loading_screen
+
+  while true; do
+    if select_project_interactive "$PROJECTS_FILE"; then
+      # Update AI tool if user cycled it in the menu (for all actions)
+      if [[ -n "${_selected_ai_tool:-}" ]]; then
+        SELECTED_AI_TOOL="$_selected_ai_tool"
+      fi
+      # shellcheck disable=SC2154
+      case "$_selected_project_action" in
+        select-project|open-once)
+          PROJECT_NAME="$_selected_project_name"
+          # shellcheck disable=SC2154
+          cd "$_selected_project_path" || exit 1
+          break
+          ;;
+        plain-terminal)
+          exec "$SHELL"
+          ;;
+        add-worktree)
+          # Loop back to menu — worktrees refresh on reload
+          continue
+          ;;
+        *)
+          # settings or unknown — loop back to menu
+          continue
+          ;;
+      esac
+    else
+      # User quit (ESC/Ctrl-C)
+      exit 0
+    fi
+  done
+fi
+
+PROJECT_DIR="$(pwd)"
+export PROJECT_DIR
+export PROJECT_NAME="${PROJECT_NAME:-$(basename "$PROJECT_DIR")}"
+SESSION_NAME="dev-${PROJECT_NAME}-$$"
+
+# Capture session baseline for line diff tracking
+GHOST_TAB_BASELINE_FILE="/tmp/ghost-tab-baseline-${SESSION_NAME}"
+if git rev-parse --git-dir > /dev/null 2>&1; then
+  git rev-parse HEAD > "$GHOST_TAB_BASELINE_FILE" 2>/dev/null
+fi
+
+# Set terminal/tab title based on tab_title setting
+_tab_title_setting="full"
+_settings_file="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab/settings"
+if [ -f "$_settings_file" ]; then
+  _saved_tab_title=$(grep '^tab_title=' "$_settings_file" 2>/dev/null | cut -d= -f2)
+  if [ -n "$_saved_tab_title" ]; then
+    _tab_title_setting="$_saved_tab_title"
+  fi
+fi
+if [ "$_tab_title_setting" = "full" ]; then
+  set_tab_title "$PROJECT_NAME" "$SELECTED_AI_TOOL"
+else
+  set_tab_title "$PROJECT_NAME"
+fi
+
+# Tab title waiting indicator
+GHOST_TAB_MARKER_FILE="/tmp/ghost-tab-waiting-$$"
+if [ "$SELECTED_AI_TOOL" = "claude" ]; then
+  _claude_settings="${HOME}/.claude/settings.json"
+  add_waiting_indicator_hooks "$_claude_settings" >/dev/null
+fi
+
+# Background watcher: switch to Claude pane once it's ready
+(
+  while true; do
+    sleep 0.5
+    content=$("$TMUX_CMD" capture-pane -t "$SESSION_NAME:0.1" -p 2>/dev/null)
+    # All three tools show a prompt character when ready
+    if echo "$content" | grep -qE '[>$❯]'; then
+      "$TMUX_CMD" select-pane -t "$SESSION_NAME:0.1"
+      break
+    fi
+  done
+) &
+WATCHER_PID=$!
+
+cleanup() {
+  stop_tab_title_watcher "$GHOST_TAB_MARKER_FILE"
+  # Remove waiting indicator hooks if no other Ghost Tab sessions are running
+  if [ "$SELECTED_AI_TOOL" = "claude" ]; then
+    # Clean up orphaned markers from dead sessions (e.g., after SIGKILL)
+    for marker in /tmp/ghost-tab-waiting-*; do
+      [ -f "$marker" ] || continue
+      local pid="${marker##*-}"
+      if ! kill -0 "$pid" 2>/dev/null; then
+        rm -f "$marker"
+      fi
+    done
+    if ! ls /tmp/ghost-tab-waiting-* &>/dev/null; then
+      remove_waiting_indicator_hooks "${HOME}/.claude/settings.json" >/dev/null 2>&1 || true
+    fi
+  fi
+  cleanup_tmux_session "$SESSION_NAME" "$WATCHER_PID" "$TMUX_CMD"
+  rm -f "$GHOST_TAB_BASELINE_FILE"
+}
+trap cleanup EXIT HUP TERM INT
+
+# Build the AI tool launch command
+case "$SELECTED_AI_TOOL" in
+  codex|opencode)
+    AI_LAUNCH_CMD="$(build_ai_launch_cmd "$SELECTED_AI_TOOL" "$CLAUDE_CMD" "$CODEX_CMD" "$COPILOT_CMD" "$OPENCODE_CMD" "$PROJECT_DIR")"
+    ;;
+  *)
+    AI_LAUNCH_CMD="$(build_ai_launch_cmd "$SELECTED_AI_TOOL" "$CLAUDE_CMD" "$CODEX_CMD" "$COPILOT_CMD" "$OPENCODE_CMD" "$*")"
+    ;;
+esac
+
+# Start tab title watcher before tmux (which blocks until session ends)
+start_tab_title_watcher "$SESSION_NAME" "$SELECTED_AI_TOOL" "$PROJECT_NAME" "$_tab_title_setting" "$TMUX_CMD" "$GHOST_TAB_MARKER_FILE" "${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab"
+
+"$TMUX_CMD" new-session -s "$SESSION_NAME" -e "PATH=$PATH" -e "GHOST_TAB_BASELINE_FILE=$GHOST_TAB_BASELINE_FILE" -e "GHOST_TAB_MARKER_FILE=$GHOST_TAB_MARKER_FILE" -c "$PROJECT_DIR" \
+  "$LAZYGIT_CMD; exec bash" \; \
+  set-option status-left " ⬡ ${PROJECT_NAME} " \; \
+  set-option status-left-style "fg=white,bg=colour236,bold" \; \
+  set-option status-style "bg=colour235" \; \
+  set-option status-right "" \; \
+  set-option set-titles off \; \
+  set-option exit-unattached on \; \
+  split-window -h -p 50 -c "$PROJECT_DIR" \
+  "$AI_LAUNCH_CMD; exec bash" \; \
+  select-pane -t 0 \; \
+  split-window -v -p 50 -c "$PROJECT_DIR" \
+  "trap exit TERM; while true; do $BROOT_CMD $PROJECT_DIR; done" \; \
+  split-window -v -p 30 -c "$PROJECT_DIR" \; \
+  select-pane -t 3