VibeGhostty 🚀

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.

---

✨ Highlights

• 🎨 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

---

🚀 Ghostty Quick Start

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.

---

⌨️ Ghostty Keybindings

Tab management

Shortcut	Action
Cmd+T	Open a new tab
Cmd+W	Close the current tab
Cmd+1~9	Jump directly to tabs 1-9
Cmd+Shift+]	Next tab
Cmd+Shift+[	Previous tab

Split management

Shortcut	Action
Cmd+D	Split right
Cmd+Shift+D	Split down

Miscellaneous

Shortcut	Action
Cmd+Shift+Comma	Reload configuration

---

💡 Workflow Examples

Claude Code + Codex CLI in parallel

# 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

Side-by-side AI comparison

# Keep Claude on the left
claude

# Cmd+D to split right for Codex
codex

# Compare outputs without leaving the terminal

Multi-project juggling

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

---

🎨 Color Palette

• 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.

---

🔧 Customization Tips

Font size

# Locate this line in config
font-size = 13

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

Reload Ghostty afterwards (Cmd+Shift+Comma).

Alternative Nerd Font

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

Scrollback history

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

---

🔥 Tmux AI Workspace Integration

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

Tmux Quick Start

# 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: Intelligent Project Startup

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.

Default layouts

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       │
└─────────────────────────────────┘

Essential tmux commands

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

Core tmux shortcuts (prefix = Ctrl+Space)

Shortcut	Action	Notes
Ctrl+Space 1/2/3	Jump to pane	Pane index navigation
Ctrl+Space d	Detach	Leave session running
Ctrl+Space m	Mode menu	Opens a temporary control pane and auto-cleans
Ctrl+Space r	Reload config	Apply edits to .tmux.conf
Ctrl+Space z	Zoom pane	Toggle fullscreen

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

Choosing Ghostty vs Tmux

Scenario	Tool	Why
Lightweight tasks, single AI	Ghostty tabs	Fast and visually clean
Complex collaboration	Tmux sessions	Sophisticated layouts, persistence
Need to preserve state	Tmux sessions	Resurrect panes after restarts
Quick experiments	Ghostty splits	Minimal setup, instant teardown

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

---

📁 Repository Layout

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)

---

🐛 Troubleshooting

Glyphs or icons look broken

Install the Nerd Font and restart Ghostty:

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

Keybindings don’t respond

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

Ghostty didn’t reload properly

Force restart:

pkill -9 ghostty && open -a Ghostty

---

📚 Resources

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

---

📄 License

MIT License

---

🤝 Contributing

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! 🎉