Ghostty the terminal for Claude Code: Config, Splits, and Scripts

brew install --cask ghostty

curl -LO https://github.com/ghostty-org/ghostty/releases/latest/download/ghostty_linux_x86_64.tar.gz
tar -xzf ghostty_linux_x86_64.tar.gz
sudo mv ghostty /usr/local/bin/ghostty

cat > setup-ghostty-claude.sh << 'OUTEREOF'
#!/usr/bin/env bash
#
# setup-ghostty-claude.sh
#
# Adds a Finder right-click Quick Action: "Launch Claude Code in Ghostty".
# Right-click any folder -> Quick Actions -> Launch Claude Code in Ghostty,
# and a new Ghostty window opens in that folder running Claude Code.
#
# macOS only. Requires Ghostty (https://ghostty.org) and Claude Code.
#
# Run it once from a terminal:
#   bash setup-ghostty-claude.sh
#
set -euo pipefail

SERVICE_NAME="Launch Claude Code in Ghostty"
SERVICE_PATH="${HOME}/Library/Services/${SERVICE_NAME}.workflow"
LAUNCHER="${HOME}/.local/bin/ghostty-claude-launcher"

# ── 1. Sanity checks ──────────────────────────────────────────────────────────
if [[ "$(uname)" != "Darwin" ]]; then
  echo "Error: this script is macOS only." >&2
  exit 1
fi
if ! osascript -e 'id of application "Ghostty"' >/dev/null 2>&1; then
  echo "Error: Ghostty is not installed. Get it from https://ghostty.org" >&2
  exit 1
fi

# ── 2. Launcher script ────────────────────────────────────────────────────────
# Locates the claude binary, cd's into the selected folder, and runs Claude Code.
# Kept as a separate file so the Quick Action command stays a one-liner.
mkdir -p "$(dirname "$LAUNCHER")"
cat > "$LAUNCHER" << 'LAUNCHER_EOF'
#!/bin/bash
# Source login files so `claude` is on PATH no matter how we were launched.
for rc in "$HOME/.zshrc" "$HOME/.bashrc" "$HOME/.bash_profile" "$HOME/.profile"; do
  [ -f "$rc" ] && source "$rc" 2>/dev/null || true
done

CLAUDE="$(command -v claude 2>/dev/null || true)"
if [ -z "$CLAUDE" ]; then
  for candidate in \
    "$HOME/.local/bin/claude" \
    "$HOME/.npm-global/bin/claude" \
    "/opt/homebrew/bin/claude" \
    "/usr/local/bin/claude" \
    "/usr/bin/claude"; do
    if [ -x "$candidate" ]; then CLAUDE="$candidate"; break; fi
  done
fi
if [ -z "$CLAUDE" ]; then
  osascript -e 'display alert "Claude Code not found" message "Install Claude Code, or make sure the claude command is on your PATH."'
  exit 1
fi

# First argument is the folder Finder passed in.
FOLDER="$1"
if [ -n "$FOLDER" ] && [ -d "$FOLDER" ]; then
  cd "$FOLDER"
fi

# caffeinate -i keeps the Mac awake while a session is running.
caffeinate -i "$CLAUDE"
LAUNCHER_EOF
chmod +x "$LAUNCHER"

# ── 3. Build the Automator Quick Action (Service) ─────────────────────────────
# The plists are generated with Python's plistlib so the embedded shell command
# is XML-escaped correctly. (Hand-writing the XML breaks the moment the command
# contains <, > or &.)
rm -rf "$SERVICE_PATH"
mkdir -p "$SERVICE_PATH/Contents"

python3 - "$SERVICE_PATH/Contents/Info.plist" "$SERVICE_NAME" << 'PYEOF'
import plistlib, sys
path, name = sys.argv[1], sys.argv[2]
plist = {
    "NSServices": [{
        "NSMenuItem": {"default": name},
        "NSMessage": "runWorkflowAsService",
        "NSRequiredContext": {"NSApplicationIdentifier": "com.apple.finder"},
        "NSSendFileTypes": ["public.folder"],
    }]
}
with open(path, "wb") as f:
    plistlib.dump(plist, f)
PYEOF

python3 - "$SERVICE_PATH/Contents/document.wflow" "$LAUNCHER" << 'PYEOF'
import plistlib, sys
path, launcher = sys.argv[1], sys.argv[2]

# macOS note: you cannot launch the Ghostty terminal via its binary directly,
# and `+new-window` is Linux-only. The supported path is:
#   open -na Ghostty.app --args ... -e <command>
# Flags passed to this instance:
#   --window-save-state=never        open a clean window; do NOT restore the
#                                    user's previous tabs/session into it
#   --quit-after-last-window-closed=true  quit (and drop the Dock icon) when the
#                                    window closes, so instances don't pile up
command = (
    'for folder in "$@"; do
'
    '  [ -d "$folder" ] || continue
'
    '  open -na Ghostty.app --args --window-save-state=never '
    '--quit-after-last-window-closed=true -e "'
    + launcher + '" "$folder" &
'
    'done
'
)

wflow = {
    "AMApplicationBuild": "521.1",
    "AMApplicationVersion": "2.10",
    "AMDocumentVersion": "2",
    "actions": [{
        "action": {
            "AMAccepts": {"Container": "List", "Optional": True,
                          "Types": ["com.apple.cocoa.path"]},
            "AMActionVersion": "2.0.3",
            "AMApplication": ["Automator"],
            "ActionBundlePath": "/System/Library/Automator/Run Shell Script.action",
            "ActionName": "Run Shell Script",
            "ActionParameters": {
                "COMMAND_STRING": command,
                "CheckedForUserDefaultShell": True,
                "inputMethod": 1,
                "shell": "/bin/bash",
                "source": "",
            },
            "BundleIdentifier": "com.apple.RunShellScript",
            "CFBundleVersion": "2.0.3",
            "CanShowSelectedItemsWhenRun": False,
            "CanShowWhenRun": True,
            "Category": ["AMCategoryUtilities"],
            "Class Name": "RunShellScriptAction",
            "InputUUID": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
            "OutputUUID": "B2C3D4E5-F6A7-8901-BCDE-F12345678901",
            "UUID": "C3D4E5F6-A7B8-9012-CDEF-123456789012",
            "UnlockPlugin": False,
            "arguments": {},
            "isViewVisible": 1,
            "location": "309.500000:253.000000",
            "nibPath": "/System/Library/Automator/Run Shell Script.action/Contents/Resources/English.lproj/main.nib",
        },
        "isViewVisible": 1,
    }],
    "connectors": {},
    "workflowMetaData": {
        "serviceApplicationBundleID": "com.apple.finder",
        "serviceApplicationPath": "/System/Library/CoreServices/Finder.app",
        "serviceInputTypeIdentifier": "com.apple.Automator.fileSystemObject.folder",
        "serviceOutputTypeIdentifier": "com.apple.Automator.nothing",
        "serviceProcessesInput": 0,
        "workflowTypeIdentifier": "com.apple.Automator.servicesMenu",
    },
}
with open(path, "wb") as f:
    plistlib.dump(wflow, f)
PYEOF

# ── 4. Register the service ───────────────────────────────────────────────────
/System/Library/CoreServices/pbs -update || true
killall Finder >/dev/null 2>&1 || true

cat << EOF

Done.

Right-click any folder in Finder ->
  Quick Actions (or Services) -> ${SERVICE_NAME}

To uninstall:
  rm -rf "${SERVICE_PATH}"
  rm -f "${LAUNCHER}"
  /System/Library/CoreServices/pbs -update && killall Finder
EOF
OUTEREOF
chmod +x setup-ghostty-claude.sh

cat > ~/ghostty-bootstrap.sh << 'OUTER_EOF'
#!/usr/bin/env bash
set -euo pipefail

# 1. Ghostty config
mkdir -p ~/.config/ghostty

cat > ~/.config/ghostty/config << 'EOF'
# ghostty/config: Claude Code optimised configuration

# Typography. JetBrains Mono Nerd Font ships ligatures plus icon glyphs
# used by eza, Starship, and Claude Code's TUI for file types and git
# symbols.
font-family = JetBrainsMonoNerdFont
font-size = 14
font-thicken = true
adjust-cell-height = 2

# Theme. Auto light or dark follows the OS appearance setting, so
# switching the Mac to dark mode changes Ghostty without restarting.
# background-opacity lets you read background windows during long
# Claude runs without switching away. The blur keeps it from being
# distracting.
theme = light:Catppuccin Latte,dark:Catppuccin Mocha
background-opacity = 0.9
background-blur-radius = 20
window-padding-x = 10
window-padding-y = 8
window-theme = auto

# Window state. Restores all splits and tabs on reopen, so your Claude
# Code layout is waiting for you the next morning.
window-save-state = always

# Cursor. A bar is less distracting than a block when reading long
# output.
cursor-style = bar
cursor-style-blink = true
cursor-opacity = 0.8

# Mouse. Hide the cursor while typing so it does not overlap Claude's
# output stream. copy-on-select puts selected text into the clipboard
# immediately, which matters when grabbing file paths or commands.
mouse-hide-while-typing = true
copy-on-select = clipboard

# Shell integration. Gives Ghostty semantic knowledge of your prompt:
# working directory tracking across splits, better scrollback
# navigation.
shell-integration = detect
shell-integration-features = cursor,sudo,title

# Performance. Claude Code generates long outputs. 100000 lines is
# generous. Disable the resize overlay; it flickers on fast redraws.
scrollback-limit = 100000
resize-overlay = never

# Split keybindings. SAND pattern (Split, Across, Navigate, Destroy).
# super+d splits right. super+shift+d splits down. super+w closes a
# pane. ctrl with vim keys navigates between panes.
keybind = super+d=new_split:right
keybind = super+shift+d=new_split:down
keybind = super+w=close_surface
keybind = ctrl+h=goto_split:left
keybind = ctrl+l=goto_split:right
keybind = ctrl+k=goto_split:top
keybind = ctrl+j=goto_split:bottom

# Tab keybindings
keybind = super+t=new_tab
keybind = super+1=goto_tab:1
keybind = super+2=goto_tab:2
keybind = super+3=goto_tab:3
keybind = super+4=goto_tab:4
keybind = super+5=goto_tab:5

# Quick terminal. Global hotkey that drops from the top of the screen
# over whatever app is focused. 150ms animation keeps it snappy.
keybind = global:super+grave_accent=toggle_quick_terminal
quick-terminal-position = top
quick-terminal-screen = main
quick-terminal-animation-duration = 0.15
EOF
echo "Ghostty config written to ~/.config/ghostty/config"

# 2. Starship prompt
if ! command -v starship &> /dev/null; then
  echo "Installing Starship..."
  mkdir -p "$HOME/.local/bin"
  curl -sS https://starship.rs/install.sh | BIN_DIR="$HOME/.local/bin" sh -s -- --yes
else
  echo "Starship already installed."
fi

mkdir -p ~/.config

cat > ~/.config/starship.toml << 'EOF'
format = """
$directory$git_branch$git_status$nodejs$python$rust$golang$java
$character"""

[character]
success_symbol = "[❯](bold green)"
error_symbol = "[❯](bold red)"

[directory]
truncation_length = 3
truncate_to_repo = true

[git_branch]
symbol = " "
format = "[$symbol$branch]($style) "
style = "bold purple"

[git_status]
format = '([\[$all_status$ahead_behind\]]($style) )'
style = "bold red"

[nodejs]
symbol = " "
format = "[$symbol($version)]($style) "

[python]
symbol = " "
format = "[$symbol($version)]($style) "
EOF
echo "Starship config written to ~/.config/starship.toml"
echo ""
echo "MANUAL STEP REQUIRED:"
echo "Add these two lines to the bottom of your ~/.zshrc on macOS or"
echo "your ~/.bashrc on Linux:"
echo ""
echo '  export PATH="$HOME/.local/bin:$PATH"'
echo '  eval "$(starship init zsh)"'
echo ""
echo "Then run: source ~/.zshrc"

# 3. JetBrains Mono Nerd Font
if [[ "$(uname)" == "Darwin" ]]; then
  # On macOS we check the user and system Fonts directories directly
  # rather than relying on fc-list, which is not installed by default.
  if ls "$HOME/Library/Fonts"/JetBrainsMono*.ttf >/dev/null 2>&1 \
     || ls /Library/Fonts/JetBrainsMono*.ttf >/dev/null 2>&1; then
    echo "JetBrains Mono Nerd Font already installed."
  else
    brew install --cask font-jetbrains-mono-nerd-font \
      || echo "Font install failed. Download manually from https://www.nerdfonts.com/font-downloads"
  fi
elif [[ "$(uname)" == "Linux" ]]; then
  FONT_DIR="${HOME}/.local/share/fonts"
  mkdir -p "${FONT_DIR}"
  if ! fc-list 2>/dev/null | grep -qi "JetBrainsMono"; then
    echo "Downloading JetBrains Mono Nerd Font..."
    TMP=$(mktemp -d)
    curl -Lo "${TMP}/JetBrainsMono.zip" \
      "https://github.com/ryanoasis/nerd-fonts/releases/latest/download/JetBrainsMono.zip"
    unzip -q "${TMP}/JetBrainsMono.zip" -d "${FONT_DIR}"
    fc-cache -fv "${FONT_DIR}" > /dev/null 2>&1
    rm -rf "${TMP}"
    echo "JetBrains Mono Nerd Font installed."
  else
    echo "JetBrains Mono Nerd Font already installed."
  fi
fi

echo ""
echo "Bootstrap complete. Restart Ghostty to pick up the new config."
echo ""
echo "Some Ghostty config keys used here (font-thicken, cursor-opacity,"
echo "quick-terminal-screen) require Ghostty 1.0 or newer. Earlier"
echo "builds will print warnings for those lines and ignore them."
OUTER_EOF
chmod +x ~/ghostty-bootstrap.sh

┌──────────────────────────┬───────────────┐
│                          │               │
│      Claude Code         │  Shell / Git  │
│        (70%)             │    (30%)      │
│                          │               │
└──────────────────────────┴───────────────┘

┌────────────────────┬────────────────────┐
│                    │                    │
│    Claude Code     │      Neovim        │
│      (50%)         │       (50%)        │
│                    │                    │
├────────────────────┴────────────────────┤
│              Shell / Test Output        │
└─────────────────────────────────────────┘

[ Tab 1: Project A ] [ Tab 2: Project B ] [ Tab 3: Scratchpad ]

tmux ls                              List all running sessions
tmux attach-session -t claude        Attach to a session named "claude"
tmux new-session -s myproject        Create a new session named "myproject"
tmux kill-session -t claude          Kill a session entirely

ctrl+b then d       Detach from the session (leaves it running in the background)
ctrl+b then $       Rename the current session
ctrl+b then c       Create a new window
ctrl+b then n       Switch to the next window
ctrl+b then p       Switch to the previous window
ctrl+b then %       Split the pane left and right
ctrl+b then "       Split the pane top and bottom
ctrl+b then arrow   Move between panes
ctrl+b then z       Zoom the current pane to full screen (press again to shrink back)

cat > ~/ghostty-tmux-claude.sh << 'OUTER_EOF'
#!/usr/bin/env bash
# Usage: ./ghostty-tmux-claude.sh [session-name] [project-dir]
#
# The first argument is the tmux session name and defaults to "claude".
# Two readers running this script back to back with no argument will
# share the same session name, which is usually what you want for a
# personal machine but worth knowing about.
set -euo pipefail

SESSION="${1:-claude}"
PROJECT_DIR="${2:-${PWD}}"

# 1. Dependencies
if ! command -v tmux &>/dev/null; then
  if ! command -v brew &>/dev/null; then
    echo "Error: tmux and Homebrew are both missing. Install Homebrew first:" >&2
    echo "  https://brew.sh" >&2
    exit 1
  fi
  echo "tmux not found. Installing via Homebrew..."
  brew install tmux
fi

# 2. tmux passthrough config
# allow-passthrough lets Claude Code notifications reach the outer
# terminal instead of being swallowed by tmux.
# extended-keys lets tmux distinguish Shift+Enter from plain Enter so
# the newline shortcut works correctly inside Claude Code.
if ! grep -qF "Claude Code passthrough" ~/.tmux.conf 2>/dev/null; then
  cat >> ~/.tmux.conf << 'TMUXEOF'

# Claude Code passthrough (added by ghostty-tmux-claude.sh)
set -g allow-passthrough on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'
TMUXEOF
fi

# Reload only if a server is already running
if tmux list-sessions &>/dev/null; then
  tmux source-file ~/.tmux.conf 2>/dev/null || true
fi

# 3. Session setup
if tmux has-session -t "${SESSION}" 2>/dev/null; then
  echo "Session '${SESSION}' already exists. Attaching."
  tmux attach-session -t "${SESSION}"
  exit 0
fi

tmux new-session -d -s "${SESSION}" -c "${PROJECT_DIR}"

# Left pane: Claude Code
tmux send-keys -t "${SESSION}:0" "claude" Enter

# Right pane: shell
tmux split-window -h -t "${SESSION}:0" -c "${PROJECT_DIR}"
tmux send-keys -t "${SESSION}:0.1" "clear" Enter

# Resize Claude Code to 65% of the window width. The percentage form
# requires tmux 3.1 or newer; on older tmux this resize is a no op
# and panes end up at the default 50% split.
TMUX_MAJOR=$(tmux -V | awk '{print $2}' | cut -d. -f1)
TMUX_MINOR=$(tmux -V | awk '{print $2}' | cut -d. -f2 | tr -dc '0-9')
if [ "${TMUX_MAJOR:-0}" -gt 3 ] || { [ "${TMUX_MAJOR:-0}" -eq 3 ] && [ "${TMUX_MINOR:-0}" -ge 1 ]; }; then
  tmux resize-pane -t "${SESSION}:0.0" -x "65%"
else
  # Fall back to an absolute column count that approximates 65% on a
  # typical 200 column window.
  tmux resize-pane -t "${SESSION}:0.0" -x 130
fi

tmux select-pane -t "${SESSION}:0.0"
tmux set-option -t "${SESSION}" history-limit 100000

tmux attach-session -t "${SESSION}"
OUTER_EOF
chmod +x ~/ghostty-tmux-claude.sh

# Start a session in your current directory (the session will be named "claude")
./ghostty-tmux-claude.sh

# Start a session with a specific name and project directory
./ghostty-tmux-claude.sh myproject ~/code/myproject

# If you close Ghostty or get disconnected, reattach with:
tmux attach-session -t myproject

Ctrl+b then →

Ctrl+b then o

cat > ~/ghostty-claude-settings.sh << 'OUTER_EOF'
#!/usr/bin/env bash
set -euo pipefail

mkdir -p ~/.claude

# 1. Back up any existing settings with a timestamp plus PID suffix so
# running this script twice in the same second cannot clobber a backup.
if [[ -f ~/.claude/settings.json ]]; then
  BACKUP=~/.claude/settings.json.bak.$(date +%Y%m%d%H%M%S).$$
  cp ~/.claude/settings.json "$BACKUP"
  echo "Existing settings backed up to $BACKUP"

  # Warn if the existing settings were not valid JSON so the reader
  # knows their original was already broken before we touched it.
  if ! python3 -c "import json,sys; json.load(open(sys.argv[1]))" "$BACKUP" 2>/dev/null; then
    echo "  Note: the previous settings.json was not valid JSON."
  fi
fi

# 2. Platform sound command
if [[ "$(uname)" == "Darwin" ]]; then
  NOTIFY_CMD="afplay /System/Library/Sounds/Glass.aiff"
else
  NOTIFY_CMD="paplay /usr/share/sounds/freedesktop/stereo/complete.oga 2>/dev/null || true"
fi

# 3. Write the new settings. The hooks block uses the current Claude
# Code schema with a matcher field alongside hooks. The matcher is an
# empty string here because we want every Notification event to fire
# the sound, not a subset.
cat > ~/.claude/settings.json << SETTINGSEOF
{
  "theme": "auto",
    "preferredNotifChannel": "ghostty",
    "syntaxHighlightingDisabled": true,
    "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "${NOTIFY_CMD}"
          }
        ]
      }
    ]
  }
}
SETTINGSEOF

echo "Claude Code settings written to ~/.claude/settings.json"
echo "  theme: auto, follows Ghostty's light or dark mode"
echo "  notifications: system, forwarded to OS notification centre by Ghostty"
echo "  sound: ${NOTIFY_CMD}"
OUTER_EOF
chmod +x ~/ghostty-claude-settings.sh

super+d             Split current pane to the right (creates a new pane alongside)
super+shift+d       Split current pane downward (creates a new pane below)
super+w             Close the current pane
ctrl+h              Move focus to the pane on the left
ctrl+l              Move focus to the pane on the right
ctrl+k              Move focus to the pane above
ctrl+j              Move focus to the pane below
super+t             Open a new tab
super+1             Switch to Tab 1
super+2             Switch to Tab 2
super+3             Switch to Tab 3 (and so on up to 5)
super+`             Toggle the drop-down quick terminal (works from any app)

shift+enter         Insert a new line without submitting (works natively in Ghostty)
ctrl+j              Insert a new line (works everywhere including inside tmux)
shift+tab twice     Switch to Plan Mode (Claude plans before acting)
/theme              Change Claude Code's colour theme to match Ghostty
/terminal-setup     Not needed in Ghostty because shift+enter works without it

cat > setup-ghostty-cursor.sh << 'EOF'
#!/usr/bin/env zsh
# setup-ghostty-cursor.sh
# Fixes the "cursor disappears after exiting Claude Code" problem in Ghostty.
# Safe to re-run — all changes are idempotent.
set -e

echo "==> Ghostty cursor fix setup"

# ── 1. Ghostty config ────────────────────────────────────────────────────────
GHOSTTY_CONFIG="$HOME/.config/ghostty/config"
mkdir -p "$(dirname "$GHOSTTY_CONFIG")"

apply_ghostty_setting() {
  local key="$1" value="$2"
  if grep -q "^${key} *=" "$GHOSTTY_CONFIG" 2>/dev/null; then
    sed -i '' "s|^${key} *=.*|${key} = ${value}|" "$GHOSTTY_CONFIG"
  else
    echo "${key} = ${value}" >> "$GHOSTTY_CONFIG"
  fi
}

echo "--> Patching Ghostty config: $GHOSTTY_CONFIG"
apply_ghostty_setting "cursor-style"       "block"
apply_ghostty_setting "cursor-style-blink" "false"
apply_ghostty_setting "cursor-color"       "#0055ff"
apply_ghostty_setting "cursor-text"        "#ffffff"

if grep -q "^shell-integration-features" "$GHOSTTY_CONFIG" 2>/dev/null; then
  sed -i '' 's/^shell-integration-features = .*/shell-integration-features = sudo,title/' "$GHOSTTY_CONFIG"
else
  echo "shell-integration-features = sudo,title" >> "$GHOSTTY_CONFIG"
fi
echo "    Ghostty config updated."

# ── 2. ~/.zshrc cursor hooks ─────────────────────────────────────────────────
ZSHRC="$HOME/.zshrc"
MARKER="# [cursor-fix] Force steady block cursor"

if grep -q "$MARKER" "$ZSHRC" 2>/dev/null; then
  echo "--> ~/.zshrc already patched, skipping."
else
  echo "--> Adding cursor hooks to $ZSHRC"
  printf '%s
' \
    '' \
    '# [cursor-fix] Force steady block cursor — fixes invisible cursor after exiting Claude Code' \
    '# precmd fires before each prompt; zle-line-init fires just before ZLE accepts input' \
    '# (after Ghostty shell integration), so the block cursor is guaranteed.' \
    '_reset_cursor_block() { printf $'"'"'\033[2 q'"'"' }' \
    'autoload -Uz add-zsh-hook' \
    'add-zsh-hook precmd _reset_cursor_block' \
    'zle-line-init() { printf $'"'"'\033[2 q'"'"' }' \
    'zle -N zle-line-init' >> "$ZSHRC"
  echo "    ~/.zshrc patched."
fi

# ── 3. claude() wrapper ───────────────────────────────────────────────────────
if grep -q "^claude ()" "$ZSHRC" 2>/dev/null || grep -q "^claude()" "$ZSHRC" 2>/dev/null; then
  if grep -q "printf.*033.*2 q" "$ZSHRC" 2>/dev/null; then
    echo "--> claude() wrapper already has cursor reset."
  else
    echo "--> NOTE: You have a claude() wrapper in ~/.zshrc but it lacks the cursor reset line."
    echo "    Add  printf \$'\033[2 q'  after 'command claude \"\$@\"' in your wrapper."
  fi
fi

# ── 4. Done ───────────────────────────────────────────────────────────────────
echo ""
echo "Done. Next steps:"
echo "  1. Fully quit Ghostty (Cmd+Q) and relaunch — config changes need a restart."
echo "  2. Open a fresh terminal tab, run 'claude', then exit."
echo "  3. Cursor should remain a solid blue block."
echo ""
echo "If cursor is still a bar: run 'printf \$'\033[2 q'' manually to confirm the"
echo "escape sequence works in your terminal, then check 'echo \$GHOSTTY_SHELL_FEATURES'."
EOF
chmod +x setup-ghostty-cursor.sh