ghost-tab 2.6.0

package/README.md

@@ -0,0 +1,151 @@
+# Ghost Tab
+
+A **`Ghostty`** + **`tmux`** wrapper that launches a four-pane dev session with **`Claude Code`**, **`lazygit`**, **`broot`**, and a spare terminal. Automatically cleans up all processes when the window is closed — no zombie **`Claude Code`** processes.
+
+![ghost-tab screenshot](docs/screenshot.png)
+
+---
+
+## Quick Start
+
+```sh
+git clone https://github.com/JackUait/ghost-tab.git && cd ghost-tab && ./bin/ghost-tab
+```
+
+That's it — only requirement is **`macOS`**. Everything (**`Ghostty`**, **`tmux`**, **`lazygit`**, **`broot`**, **`Claude Code`**) is installed automatically.
+
+---
+
+## Usage
+
+**Step 1.** Open a new **`Ghostty`** window (`Cmd+N`)
+
+**Step 2.** Use the interactive project selector:
+
+```
+⬡  Ghost Tab
+──────────────────────────────────────
+
+ 1❯ my-app
+    ~/Projects/my-app
+  2 another-project
+    ~/Projects/another-project
+──────────────────────────────────────
+  A Add new project
+  D Delete a project
+  O Open once
+  P Plain terminal
+──────────────────────────────────────
+  ↑↓ navigate  ⏎ select
+```
+
+- **Arrow keys** or **mouse click** to navigate
+- **Number keys** (1-9) to jump directly to a project
+- **Letter keys** — **A** add, **D** delete, **O** open once, **P** plain terminal
+- **Enter** to select
+- **Path autocomplete** when adding projects (with Tab completion)
+- **Plain terminal** opens a bare shell with no tmux overhead
+
+**Step 3.** The four-pane **`tmux`** session launches automatically with **`Claude Code`** already focused — start typing your prompt right away.
+
+> [!TIP]
+> You can also open a specific project directly from the terminal:
+> ```sh
+> ~/.config/ghostty/claude-wrapper.sh /path/to/project
+> ```
+
+---
+
+## Hotkeys
+
+| Shortcut | Action |
+|---|---|
+| `Cmd+T` | New tab |
+| `Cmd+Shift+Left` | Previous tab |
+| `Cmd+Shift+Right` | Next tab |
+| `Left Option` | Acts as `Alt` instead of typing special characters |
+
+---
+
+## What `ghost-tab` Does
+
+1. Downloads **`tmux`**, **`lazygit`**, **`broot`**, and **`jq`** natively (no package manager required)
+2. Installs **`Claude Code`** via native installer (auto-updates)
+3. Prompts to install **`Ghostty`** from ghostty.org if not already installed
+4. Sets up the **`Ghostty`** config (with merge option if you have an existing one)
+5. Walks you through adding your **project directories**
+6. Installs **`Node.js`** LTS (if needed) and sets up **Claude Code status line** showing git info and context usage
+7. Auto-updates via **`git pull`** in the background — notifies on next launch
+
+---
+
+## Status Line
+
+The `ghost-tab` command configures a custom **Claude Code** status line based on [Matt Pocock's guide](https://www.aihero.dev/creating-the-perfect-claude-code-status-line):
+
+```
+my-project | main | S: 0 | U: 2 | A: 1 | 23.5%
+```
+
+- **Repository name** — current project
+- **Branch** — current git branch
+- **S** — staged files count
+- **U** — unstaged files count
+- **A** — untracked (added) files count
+- **Context %** — how much of Claude's context window is used
+
+> [!TIP]
+> Monitor context usage to know when to start a new conversation. Lower is better.
+
+---
+
+## Process Cleanup
+
+> [!CAUTION]
+> When you close the **`Ghostty`** window, **all processes are force-terminated** — make sure your work is saved.
+
+The wrapper automatically:
+
+1. **Recursively kills** the full process tree of every **`tmux`** pane (including deeply nested subprocesses spawned by **`Claude Code`**, **`lazygit`**, etc.)
+2. **Force-kills** (`SIGKILL`) any processes that ignored the initial `SIGTERM` after a brief grace period
+3. **Destroys** the **`tmux`** session
+4. **Self-destructs** the session via `destroy-unattached` if the **`tmux`** client disconnects without triggering cleanup
+
+This prevents zombie **`Claude Code`** processes from accumulating.
+
+---
+
+## Architecture
+
+Ghost Tab uses a **hybrid architecture**:
+
+**Layer 1: Go TUI Binary (`ghost-tab-tui`)**
+- Interactive terminal UI components built with Bubbletea
+- Project selector, AI tool selector, settings menu, input forms
+- Outputs structured JSON for bash consumption
+- Binary: `~/.local/bin/ghost-tab-tui`
+
+**Layer 2: Bash Orchestration (`ghost-tab`)**
+- Entry point and session orchestration
+- Process management, config file operations
+- Calls ghost-tab-tui for interactive parts
+- Parses JSON responses with jq
+- Script: `~/.local/bin/ghost-tab`
+
+**Dependencies:**
+- Go 1.21+ (for building)
+- jq (for JSON parsing)
+- tmux (session management)
+- Ghostty (terminal emulator)
+
+**Communication:**
+```bash
+# Bash calls Go with subcommand
+result=$(ghost-tab-tui select-project --projects-file ~/.config/ghost-tab/projects)
+
+# Go returns JSON
+{"name": "my-project", "path": "/home/user/code/my-project", "selected": true}
+
+# Bash parses with jq
+project_name=$(echo "$result" | jq -r '.name')
+```

package/VERSION

@@ -0,0 +1 @@
+2.6.0

package/bin/ghost-tab

@@ -0,0 +1,360 @@
+#!/bin/bash
+set -e
+
+# Wrap everything in a function so `curl | bash` reads the entire
+# script into memory before executing.  Without this, bash reads
+# line-by-line from the pipe and `read` consumes script lines as input.
+main() {
+
+# Ensure ~/.local/bin is in PATH (where ghost-tab-tui gets installed)
+export PATH="$HOME/.local/bin:$PATH"
+
+# Determine where supporting files live
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SHARE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+source "$SHARE_DIR/lib/tui.sh"
+source "$SHARE_DIR/lib/install.sh"
+source "$SHARE_DIR/lib/terminal-select-tui.sh"
+source "$SHARE_DIR/lib/terminals/registry.sh"
+source "$SHARE_DIR/lib/terminals/adapter.sh"
+source "$SHARE_DIR/lib/settings-json.sh"
+source "$SHARE_DIR/lib/ai-select-tui.sh"
+source "$SHARE_DIR/lib/statusline-setup.sh"
+source "$SHARE_DIR/lib/project-actions.sh"
+source "$SHARE_DIR/lib/project-actions-tui.sh"
+source "$SHARE_DIR/lib/update.sh"
+
+# ---------- Terminal-only setup ----------
+run_terminal_setup() {
+  local share_dir="$1"
+
+  # Ensure TUI binary is up to date (--terminal path skips main flow checks)
+  header "Checking TUI binary..."
+  if ! ensure_ghost_tab_tui "$share_dir"; then
+    exit 1
+  fi
+
+  header "Selecting terminal..."
+  echo ""
+  echo -e "  Ghost Tab supports multiple terminal emulators."
+  echo -e "  Select your preferred terminal:"
+  echo ""
+
+  if select_terminal_interactive; then
+    if [[ -z "$_selected_terminal" ]]; then
+      error "Internal error: TUI did not set terminal"
+      exit 1
+    fi
+    local selected_terminal="$_selected_terminal"
+
+    # Save preference
+    local pref_dir="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab"
+    mkdir -p "$pref_dir"
+    save_terminal_preference "$selected_terminal" "$pref_dir/terminal"
+
+    echo ""
+    success "Selected terminal: $(get_terminal_display_name "$selected_terminal")"
+
+    # Install terminal if needed
+    header "Checking $(get_terminal_display_name "$selected_terminal")..."
+    load_terminal_adapter "$selected_terminal"
+    if ! terminal_install; then
+      error "Terminal installation failed. Install manually and re-run: ghost-tab --terminal"
+      exit 1
+    fi
+
+    # Ensure wrapper symlink exists
+    header "Setting up wrapper script..."
+    local wrapper_dir="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab"
+    mkdir -p "$wrapper_dir"
+    ln -sf "$share_dir/wrapper.sh" "$wrapper_dir/wrapper.sh"
+    success "Linked wrapper.sh in $wrapper_dir/"
+
+    if [ -d "$share_dir/lib" ]; then
+      [ -d "$wrapper_dir/lib" ] && [ ! -L "$wrapper_dir/lib" ] && rm -rf "${wrapper_dir:?}/lib"
+      ln -sfn "$share_dir/lib" "$wrapper_dir/lib"
+    fi
+
+    # Configure terminal
+    header "Setting up $(get_terminal_display_name "$selected_terminal") config..."
+    local terminal_config
+    terminal_config="$(terminal_get_config_path)"
+    local wrapper_path
+    wrapper_path="$(terminal_get_wrapper_path)"
+
+    if [ -f "$terminal_config" ]; then
+      warn "Existing config found at $terminal_config"
+      echo ""
+      echo -e "  ${_BOLD}1)${_NC} Merge — add the wrapper command to your existing config"
+      echo -e "  ${_BOLD}2)${_NC} Skip — don't modify the config (manual setup required)"
+      echo ""
+      read -rn1 -p "$(echo -e "${_BLUE}Choose (1/2):${_NC} ")" config_choice </dev/tty
+      echo ""
+
+      case "$config_choice" in
+        1) terminal_setup_config "$terminal_config" "$wrapper_path" ;;
+        *) info "Skipped config modification. Add the wrapper manually." ;;
+      esac
+    else
+      mkdir -p "$(dirname "$terminal_config")"
+      terminal_setup_config "$terminal_config" "$wrapper_path"
+    fi
+
+    echo ""
+    success "Terminal configured: $(get_terminal_display_name "$selected_terminal")"
+    info "Open a new $(get_terminal_display_name "$selected_terminal") window to start coding."
+  else
+    warn "Terminal setup did not complete. Run 'ghost-tab --terminal' to try again."
+    exit 1
+  fi
+}
+
+# ---------- Argument parsing ----------
+case "${1:-}" in
+  --terminal)
+    run_terminal_setup "$SHARE_DIR"
+    exit 0
+    ;;
+  --*)
+    error "Unknown flag: $1"
+    echo "Usage: ghost-tab [--terminal]"
+    exit 1
+    ;;
+esac
+
+# ---------- OS check ----------
+header "Checking platform..."
+if [ "$(uname)" != "Darwin" ]; then
+  error "This setup script only supports macOS."
+  exit 1
+fi
+success "macOS detected"
+notify_if_updated
+
+# ---------- Dependencies ----------
+header "Installing dependencies..."
+ensure_base_requirements
+
+# ---------- TUI Binary ----------
+header "Checking TUI binary..."
+if ! ensure_ghost_tab_tui "$SHARE_DIR"; then
+  exit 1
+fi
+
+# ---------- AI Coding Tools ----------
+header "Setting up AI coding tools..."
+echo ""
+echo -e "  Ghost Tab supports multiple AI coding assistants."
+echo -e "  Select your preferred AI tool:"
+echo ""
+
+# Use TUI to select AI tool
+if select_ai_tool_interactive; then
+  # Variable set by select_ai_tool_interactive: _selected_ai_tool
+  if [[ -z "$_selected_ai_tool" ]]; then
+    error "Internal error: TUI did not set AI tool"
+    exit 1
+  fi
+  SELECTED_AI_TOOL="$_selected_ai_tool"
+
+  # Save preference
+  AI_TOOL_PREF_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab"
+  mkdir -p "$AI_TOOL_PREF_DIR"
+  echo "$SELECTED_AI_TOOL" > "$AI_TOOL_PREF_DIR/ai-tool"
+
+  echo ""
+  success "Selected AI tool: $SELECTED_AI_TOOL"
+
+  # Install the selected tool
+  case "$SELECTED_AI_TOOL" in
+    claude)
+      ensure_command "claude" "curl -fsSL https://claude.ai/install.sh | bash" \
+        "Run 'claude' to authenticate before launching Ghost Tab." "Claude Code"
+      ;;
+    codex)
+      ensure_command "codex" "brew install --cask codex" "" "Codex CLI"
+      ;;
+    copilot)
+      ensure_command "copilot" "brew install copilot-cli" "" "Copilot CLI"
+      ;;
+    opencode)
+      ensure_command "opencode" "brew install anomalyco/tap/opencode" "" "OpenCode"
+      ;;
+  esac
+else
+  info "AI tool selection cancelled"
+  exit 1
+fi
+
+# ---------- Terminal Selection ----------
+header "Selecting terminal..."
+echo ""
+echo -e "  Ghost Tab supports multiple terminal emulators."
+echo -e "  Select your preferred terminal:"
+echo ""
+
+if select_terminal_interactive; then
+  if [[ -z "$_selected_terminal" ]]; then
+    error "Internal error: TUI did not set terminal"
+    exit 1
+  fi
+  SELECTED_TERMINAL="$_selected_terminal"
+
+  # Save preference
+  TERMINAL_PREF_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab"
+  mkdir -p "$TERMINAL_PREF_DIR"
+  save_terminal_preference "$SELECTED_TERMINAL" "$TERMINAL_PREF_DIR/terminal"
+
+  echo ""
+  success "Selected terminal: $(get_terminal_display_name "$SELECTED_TERMINAL")"
+else
+  warn "Terminal setup did not complete. Run 'ghost-tab --terminal' to try again."
+  exit 1
+fi
+
+# ---------- Terminal Installation ----------
+header "Checking $(get_terminal_display_name "$SELECTED_TERMINAL")..."
+load_terminal_adapter "$SELECTED_TERMINAL"
+if ! terminal_install; then
+  error "Terminal installation failed. Install manually and re-run: ghost-tab --terminal"
+  exit 1
+fi
+
+# Verify supporting files exist
+if [ ! -f "$SHARE_DIR/wrapper.sh" ] || [ ! -d "$SHARE_DIR/templates" ]; then
+  error "Supporting files not found in $SHARE_DIR. Re-clone the repo and try again."
+  exit 1
+fi
+
+# ---------- Wrapper Script ----------
+header "Setting up wrapper script..."
+WRAPPER_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab"
+mkdir -p "$WRAPPER_DIR"
+ln -sf "$SHARE_DIR/wrapper.sh" "$WRAPPER_DIR/wrapper.sh"
+success "Linked wrapper.sh in $WRAPPER_DIR/"
+
+# Symlink shared libraries (remove old copies if present)
+if [ -d "$SHARE_DIR/lib" ]; then
+  [ -d "$WRAPPER_DIR/lib" ] && [ ! -L "$WRAPPER_DIR/lib" ] && rm -rf "${WRAPPER_DIR:?}/lib"
+  ln -sfn "$SHARE_DIR/lib" "$WRAPPER_DIR/lib"
+  success "Linked shared libraries to $WRAPPER_DIR/lib/"
+fi
+
+# ---------- Ghost Tab CLI Command ----------
+header "Setting up ghost-tab command..."
+ln -sf "$SHARE_DIR/bin/ghost-tab-config" "$HOME/.local/bin/ghost-tab"
+success "Created ghost-tab command at ~/.local/bin/ghost-tab"
+
+# ---------- Terminal Config ----------
+header "Setting up $(get_terminal_display_name "$SELECTED_TERMINAL") config..."
+TERMINAL_CONFIG="$(terminal_get_config_path)"
+WRAPPER_PATH="$(terminal_get_wrapper_path)"
+
+if [ -f "$TERMINAL_CONFIG" ]; then
+  warn "Existing config found at $TERMINAL_CONFIG"
+  echo ""
+  echo -e "  ${_BOLD}1)${_NC} Merge — add the wrapper command to your existing config"
+  echo -e "  ${_BOLD}2)${_NC} Skip — don't modify the config (manual setup required)"
+  echo ""
+  read -rn1 -p "$(echo -e "${_BLUE}Choose (1/2):${_NC} ")" config_choice </dev/tty
+  echo ""
+
+  case "$config_choice" in
+    1) terminal_setup_config "$TERMINAL_CONFIG" "$WRAPPER_PATH" ;;
+    *) info "Skipped config modification. Add the wrapper manually." ;;
+  esac
+else
+  mkdir -p "$(dirname "$TERMINAL_CONFIG")"
+  terminal_setup_config "$TERMINAL_CONFIG" "$WRAPPER_PATH"
+fi
+
+# Migrate from old config location
+OLD_PROJECTS_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/vibecode-editor"
+NEW_PROJECTS_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab"
+if [ -d "$OLD_PROJECTS_DIR" ] && [ ! -d "$NEW_PROJECTS_DIR" ]; then
+  mv "$OLD_PROJECTS_DIR" "$NEW_PROJECTS_DIR"
+  info "Migrated config from vibecode-editor to ghost-tab"
+fi
+
+# ---------- Projects ----------
+header "Setting up projects..."
+PROJECTS_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab"
+PROJECTS_FILE="$PROJECTS_DIR/projects"
+mkdir -p "$PROJECTS_DIR"
+
+echo ""
+read -rn1 -p "$(echo -e "${_BLUE}Add a project? (y/n):${_NC} ")" add_project </dev/tty
+echo ""
+
+while [[ "$add_project" =~ ^[yY]$ ]]; do
+  if add_project_interactive; then
+    # shellcheck disable=SC2154  # _add_project_name and _add_project_path are set by add_project_interactive
+    add_project_to_file "$_add_project_name" "$_add_project_path" "$PROJECTS_FILE"
+    success "Added project: $_add_project_name"
+  else
+    info "Cancelled"
+  fi
+
+  echo ""
+  read -rn1 -p "$(echo -e "${_BLUE}Add another? (y/n):${_NC} ")" add_project </dev/tty
+  echo ""
+done
+
+if [ -f "$PROJECTS_FILE" ] && [ -s "$PROJECTS_FILE" ]; then
+  success "Projects saved to $PROJECTS_FILE"
+else
+  info "No projects added. Add them later to $PROJECTS_FILE"
+fi
+
+# ---------- Claude Code Status Line ----------
+if [ "$SELECTED_AI_TOOL" = "claude" ]; then
+  header "Setting up Claude Code status line..."
+  CLAUDE_SETTINGS="$HOME/.claude/settings.json"
+  setup_statusline "$SHARE_DIR" "$CLAUDE_SETTINGS" "$HOME"
+else
+  header "Skipping Claude Code status line..."
+  info "Status line features are only available with Claude Code"
+fi
+
+# Codex CLI status line (always configure if Codex is selected)
+if [ "$SELECTED_AI_TOOL" = "codex" ]; then
+  header "Setting up Codex CLI status line..."
+  mkdir -p ~/.codex
+  # Only add status_line if not already present
+  if [ ! -f ~/.codex/config.toml ] || ! grep -q 'status_line' ~/.codex/config.toml 2>/dev/null; then
+    if ! grep -q '^\[tui\]' ~/.codex/config.toml 2>/dev/null; then
+      printf '\n[tui]\n' >> ~/.codex/config.toml
+    fi
+    printf 'status_line = ["model-with-reasoning", "git-branch", "context-remaining", "used-tokens"]\n' >> ~/.codex/config.toml
+    success "Codex CLI status line configured (model, branch, context, tokens)"
+  else
+    success "Codex CLI status line already configured"
+  fi
+fi
+
+# ---------- Summary ----------
+header "Setup complete!"
+echo ""
+success "Wrapper script:  ~/.config/ghost-tab/wrapper.sh (symlink)"
+_terminal_pref="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab/terminal" 2>/dev/null)"
+success "Terminal:        $(get_terminal_display_name "$_terminal_pref")"
+_ai_default="$(cat "${XDG_CONFIG_HOME:-$HOME/.config}/ghost-tab/ai-tool" 2>/dev/null)"
+success "AI tool:         $(echo "$_ai_default" | sed 's/claude/Claude Code/;s/codex/Codex CLI/;s/copilot/Copilot CLI/;s/opencode/OpenCode/')"
+success "Projects file:   $PROJECTS_FILE"
+success "Config command:  ghost-tab (in ~/.local/bin/)"
+if [ -f ~/.claude/statusline-wrapper.sh ]; then
+  success "Status line:     ~/.claude/statusline-wrapper.sh"
+fi
+if [ -f ~/.codex/config.toml ]; then
+  success "Codex config:    ~/.codex/config.toml"
+fi
+if [ -f "${XDG_CONFIG_HOME:-$HOME/.config}/opencode/plugins/ghost-tab.ts" ]; then
+  success "OpenCode plugin: ~/.config/opencode/plugins/ghost-tab.ts"
+fi
+echo ""
+info "Run 'ghost-tab' to manage configuration, or open a new $(get_terminal_display_name "${SELECTED_TERMINAL:-$_terminal_pref}") window to start coding."
+
+} # end main
+
+main "$@"

package/bin/npx-ghost-tab.js

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+const os = require('os');
+
+const REPO = 'JackUait/ghost-tab';
+
+// Allow overrides for testing
+const home = process.env.HOME || os.homedir();
+const installDir = process.env.GHOST_TAB_INSTALL_DIR
+  || path.join(home, '.local', 'share', 'ghost-tab');
+const tuiBinDir = path.join(home, '.local', 'bin');
+const tuiBinPath = path.join(tuiBinDir, 'ghost-tab-tui');
+
+// Package root (where npm extracted us)
+const pkgRoot = path.resolve(__dirname, '..');
+
+function main() {
+  // Platform check
+  const platform = process.env.GHOST_TAB_MOCK_PLATFORM || process.platform;
+  if (platform !== 'darwin') {
+    process.stderr.write(`Error: ghost-tab only supports macOS (detected: ${platform})\n`);
+    process.exit(1);
+  }
+
+  const version = fs.readFileSync(path.join(pkgRoot, 'VERSION'), 'utf8').trim();
+
+  // Check if already installed at correct version
+  const versionMarker = path.join(installDir, '.version');
+  let installedVersion = '';
+  try {
+    installedVersion = fs.readFileSync(versionMarker, 'utf8').trim();
+  } catch (_) {
+    // Not installed yet
+  }
+
+  if (installedVersion === version) {
+    process.stdout.write(`ghost-tab ${version} already up to date\n`);
+  } else {
+    // Copy bash distribution to install dir
+    process.stdout.write(`Installing ghost-tab ${version} to ${installDir}...\n`);
+    copyDistribution(pkgRoot, installDir);
+    fs.writeFileSync(versionMarker, version + '\n');
+    process.stdout.write(`Installed ghost-tab ${version}\n`);
+  }
+
+  // Download TUI binary if needed
+  if (!process.env.GHOST_TAB_SKIP_TUI_DOWNLOAD) {
+    ensureTuiBinary(version);
+  }
+
+  // Exec the bash installer
+  if (!process.env.GHOST_TAB_SKIP_EXEC) {
+    const installer = path.join(installDir, 'bin', 'ghost-tab');
+    const args = process.argv.slice(2);
+    try {
+      execFileSync('bash', [installer, ...args], { stdio: 'inherit' });
+    } catch (err) {
+      process.exit(err.status || 1);
+    }
+  }
+}
+
+// Recursively copy the bash distribution files.
+function copyDistribution(src, dest) {
+  const entries = [
+    'bin/ghost-tab',
+    'lib',
+    'templates',
+    'ghostty',
+    'terminals',
+    'wrapper.sh',
+    'VERSION',
+  ];
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry);
+    if (!fs.existsSync(srcPath)) continue;
+    const destPath = path.join(dest, entry);
+    copyRecursive(srcPath, destPath);
+  }
+}
+
+function copyRecursive(src, dest) {
+  const stat = fs.statSync(src);
+  if (stat.isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const child of fs.readdirSync(src)) {
+      copyRecursive(path.join(src, child), path.join(dest, child));
+    }
+  } else {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(src, dest);
+    // Preserve executable bit
+    if (stat.mode & 0o111) {
+      fs.chmodSync(dest, stat.mode);
+    }
+  }
+}
+
+// Download the TUI binary from GitHub Releases if missing or wrong version.
+function ensureTuiBinary(version) {
+  // Check if existing binary matches version
+  try {
+    const out = execFileSync(tuiBinPath, ['--version'], { encoding: 'utf8' });
+    const installed = out.replace(/.*version\s*/, '').trim();
+    if (installed === version) {
+      process.stdout.write(`ghost-tab-tui ${version} already up to date\n`);
+      return;
+    }
+    process.stdout.write(`Updating ghost-tab-tui (${installed} -> ${version})...\n`);
+  } catch (_) {
+    process.stdout.write(`Downloading ghost-tab-tui ${version}...\n`);
+  }
+
+  const arch = process.arch === 'x64' ? 'amd64' : process.arch;
+  const url = `https://github.com/${REPO}/releases/download/v${version}/ghost-tab-tui-darwin-${arch}`;
+
+  fs.mkdirSync(tuiBinDir, { recursive: true });
+  downloadFile(url, tuiBinPath);
+  fs.chmodSync(tuiBinPath, 0o755);
+  process.stdout.write(`ghost-tab-tui ${version} installed\n`);
+}
+
+// Synchronous HTTPS download with redirect following.
+function downloadFile(url, dest) {
+  try {
+    execFileSync('curl', ['-fsSL', '-o', dest, url], {
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+  } catch (_) {
+    process.stderr.write(`Failed to download ${url}\n`);
+    process.stderr.write('Check your network connection and that this version has been released.\n');
+    process.exit(1);
+  }
+}
+
+main();

package/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