ghostty-ai-session

Launch AI coding sessions (Claude, Gemini, Codex) from Ghostty with visual state tracking via terminal background color and tab title.

• ws — fzf picker: choose a git worktree, then choose a model, then launch
• Terminal background turns amber while the AI is busy, green when idle
• Tab title shows spinner, current tool, branch, and git diff stats (⠋ Claude busy · main +12 -3)
• Desktop notification + sound when the session finishes

Requirements

• Ghostty
• fzf
• Python 3.11+
• At least one of: claude, gemini, codex

Install

git clone https://github.com/yourname/ghostty-ai-session
cd ghostty-ai-session
./scripts/install.sh

Usage

Run ws in any git repo.

1. Pick a worktree (or create one with +)
2. Pick a model
3. The session launches — background and tab title reflect live state

Worktree picker keys: j/k move · x delete · Enter select · Esc quit

Sound

Plays Glass.aiff on session complete (macOS only).

GHOSTTY_AGENT_SOUND_DISABLE=1           # disable
GHOSTTY_AGENT_SOUND_FILE=/path/to.aiff  # custom sound

License

MIT