A Ghostty terminal configuration tuned for multi-AI collaboration

VibeGhostty delivers a ready-to-use Ghostty and Tmux setup crafted for pairing tools such as Claude Code and Codex CLI. It focuses on fast workspace switching, consistent visuals, and workflows tailored for AI-assisted development.

• 🎨 Tokyo Night Storm theme for cohesive, low-contrast visuals
• 🔤 JetBrains Mono Nerd Font with full glyph and icon support
• ⌨️ Productive keybindings for tabs, splits, and window management
• 🤖 AI-friendly layouts that keep assistants and monitors in view
• 📊 Large scrollback buffers so conversations stay at your fingertips
• 🚀 Intelligent project startup (vibe-start) - zero-config workspace creation

1. Install the font

   brew install --cask font-jetbrains-mono-nerd-font

2. Copy the configuration

   cp config ~/Library/Application\ Support/com.mitchellh.ghostty/config

3. Reload Ghostty Press Cmd+Shift+Comma inside Ghostty or restart the app.

# Tab 1 – Claude Code primary workspace
claude

# Cmd+T → new tab
# Tab 2 – Codex CLI assistant
codex

# Switch between them with Cmd+1 / Cmd+2

# Keep Claude on the left
claude

# Cmd+D to split right for Codex
codex

# Compare outputs without leaving the terminal

Tab 1: Project A – Claude Code
Tab 2: Project A – test watcher
Tab 3: Project B – Codex CLI
Tab 4: Project B – log tailing

Use Cmd+1/2/3/4 to hop instantly

• Background: #24283b
• Foreground: #c0caf5
• Cursor: #ff9e64
• Selection: #364a82

ANSI accents follow the Tokyo Night Storm palette (#f7768e, #7aa2f7, #9ece6a, etc.) to keep text, warnings, and highlights consistent across Ghostty and Tmux.

# Locate this line in config
font-size = 13

# Adjust to taste
font-size = 12
font-size = 14

Reload Ghostty afterwards (Cmd+Shift+Comma).

brew install --cask font-fira-code-nerd-font
# Then update the config
font-family = Fira Code

scrollback-limit = 100000   # more history
scrollback-limit = 20000    # lighter memory footprint

Ghostty covers the UI layer, while Tmux manages long-lived sessions and complex layouts. Together they unlock:

• 📐 Preset AI layouts (Workspace, Compare, Focus)
• 💾 Persistent sessions that survive restarts
• ⚡ Vim-style navigation for panes and windows
• 🎨 Shared theme for a consistent look

# Option 1: install from the repo (recommended when cloning locally)
cd ~/Documents/GitHub/VibeGhostty/tmux
bash install.sh

# Option 2: one-liner installer (macOS/Linux)
bash <(curl -fsSL https://raw.githubusercontent.com/frankekn/VibeGhostty/master/tmux/install.sh)

# Launch the interactive workspace picker (manual start)
tmux-launch

# Or jump straight into an auto-configured session
vibe-start

tmux-launch 只建立 panes，命令仍由你決定何時執行；vibe-start 則會偵測專案並自動在各 pane 注入建議命令。

vibe-start removes the “open tmux → rearrange panes → start tools” grind. It detects your project, launches the right layout, and injects commands into each pane—while still letting you override everything with flags or environment variables.

What's available in v0.1.0

• 🔍 Smart detection for Next.js, generic Node.js, and Python repos
• ⚙️ Command heuristics (npm run dev, pytest, AI CLIs) that run automatically in their panes
• 👁️ Preview & dry-run: review the plan before anything executes
• ♻️ Session recreation: existing sessions are replaced without interactive prompts
• 🧪 Mode presets: --mode debug / --mode review switch to the AI Split layout for side-by-side agents

Usage examples:

vibe-start                   # detect + preview + launch
vibe-start --dry-run         # print plan only
vibe-start --mode review --yes
vibe-start --project ../api  # launch for another directory

Need more control? Override defaults with environment variables (VIBE_AI_PRIMARY, VIBE_AI_LEFT, VIBE_CMD_*) or pass --layout / --type / --mode to steer the workflow.

AI Workspace (70/30 split) – Claude or Codex on the left, assistant + monitor panes on the right.

┌─────────────────────────┬─────────────┐
│   Codex CLI (70%)       │  Claude     │
│                         │  Code (30%) │
│                         ├─────────────┤
│                         │  Monitor    │
└─────────────────────────┴─────────────┘

AI Split (50/50) – direct comparison between two AI tools with a shared monitor pane.

┌────────────────┬────────────────┐
│  Codex CLI     │  Claude Code   │
│  (50%)         │  (50%)         │
├────────────────┴────────────────┤
│  Compare/Monitor (25%)          │
└─────────────────────────────────┘

Full Focus (100%) – dedicate the entire window to a single tool for deep work.

┌─────────────────────────────────┐
│  Claude Code or Codex CLI       │
└─────────────────────────────────┘

tmux-launch                 # interactive layout picker
~/.tmux-layouts/ai-workspace.sh  # launch a layout directly
tmux attach                 # resume the last session

For the full reference, see TMUX_GUIDE.md and QUICKSTART_TMUX.md.

Use Ghostty for structure and Tmux for orchestration—the combination delivers the best experience.

VibeGhostty/
├── README.md              # This quickstart document (English)
├── config                 # Primary Ghostty configuration
├── DESIGN.md              # vibe-start feature design (v1.0 MVP)
├── GUIDE.md               # In-depth Ghostty guide (Traditional Chinese)
├── INSTALL.md             # Installation walk-through (Traditional Chinese)
├── QUICKSTART.md          # Five-minute Ghostty setup (Traditional Chinese)
├── TMUX_GUIDE.md          # Complete tmux manual (Traditional Chinese)
├── QUICKSTART_TMUX.md     # tmux quickstart (Traditional Chinese)
├── VIBE_CONFIG_DESIGN.md  # Two-tier config system design (v1.1+)
├── docs/
│   ├── MVP_ANALYSIS.md         # Feature prioritization and MVP scope
│   └── COMPLEXITY_ANALYSIS.md  # Design simplification analysis
└── tmux/
    ├── tmux.conf          # Main tmux configuration
    ├── install.sh         # Automated installer
    ├── layouts/           # Workspace scripts
    └── bin/               # Helper utilities (tmux-launch, vibe-help, ta)

Install the Nerd Font and restart Ghostty:

brew install --cask font-jetbrains-mono-nerd-font

1. Check for global macOS shortcut conflicts
2. Reload the config with Cmd+Shift+Comma
3. Restart Ghostty if needed

Force restart:

pkill -9 ghostty && open -a Ghostty

• Ghostty documentation
• Ghostty configuration reference
• Nerd Fonts
• Tokyo Night theme

MIT License

Issues and pull requests are welcome—feel free to share improvements or new layouts!

Configuration version: 1.0.0 Last updated: 2025-10-19 Tested Ghostty version: 1.0+

Enjoy a smoother AI-assisted terminal workflow! 🎉