👻 Ghostty + Tmux Agent Setup

A slick multi-pane terminal setup that auto-reattaches tmux sessions across restarts. Works on macOS, Linux, and Windows (via WSL).

✨ Features

• Auto-reattach: Opens Ghostty → automatically grabs the oldest unattached tmux session
• Fresh grid layout: If no sessions exist, creates an 8-pane grid (4 Code Puppy panes + 4 scratch panes)
• Platform-native keybinds: ⌘+D on macOS, Ctrl+D on Linux/Windows
• Auto-install dependencies: Installs tmux and Ghostty if missing
• Kanagawa Wave theme: Beautiful transparency and colors
• Session persistence: Sessions survive terminal closes (but not reboots — tmux limitation)

🚀 Quick Install

curl -fsSL https://raw.githubusercontent.com/Nate0-1999/ghostty_tmux_agent_setup/main/ghostty-tmux-setup.sh | bash

Or clone and run:

git clone https://github.com/Nate0-1999/ghostty_tmux_agent_setup.git
cd ghostty_tmux_agent_setup
./ghostty-tmux-setup.sh

💻 Platform Support

Platform	tmux Install	Ghostty Install	Clipboard
macOS	brew install tmux	brew install --cask ghostty	pbcopy
Linux	apt/dnf/pacman	snap (or manual)	xclip
WSL	apt	winget (Windows side)	clip.exe

WSL Note: tmux runs in WSL, Ghostty runs on Windows and connects to WSL.

⌨️ Keybinds Cheat Sheet

Action	macOS	Linux/Windows
Split right	⌘+D	Ctrl+D
Split down	⌘+Shift+D	Ctrl+Shift+D
Close pane	⌘+W	Ctrl+W
Navigate panes	⌘+Alt+Arrow	Ctrl+Alt+Arrow
Resize panes	⌘+Ctrl+Arrow	Ctrl+Ctrl+Arrow
Cycle panes	⌘+[ / ⌘+]	Ctrl+[ / Ctrl+]
Zoom pane	⌘+Shift+Enter	Ctrl+Shift+Enter
Equalize panes	⌘+Ctrl+=	Ctrl+Ctrl+=
Kill session	⌘+Shift+Q	Ctrl+Shift+Q

Tmux-native Keybinds (all platforms)

Action	Keybind
Rename session	Ctrl+A, N
Reload config	Ctrl+A, r
Split right	Ctrl+A, v
Split down	Ctrl+A, s
Kill session	Ctrl+A, Q

CLI Utility

tname my-session    # Rename current tmux session
tname               # Prompts for name

📁 What Gets Installed

File	Purpose
~/.tmux.conf	Tmux config with Kanagawa theme
~/.local/bin/agents	Startup script (reattach + grid layout)
/tname	Session rename utility
~/.config/ghostty/config	Ghostty main config
~/.config/ghostty/presets/kanagawa-wave-transparent	Theme preset

🔧 Configuration

The installer will ask:

• Auto-launch Code Puppy in panes? — If yes, Code Puppy will auto-start in the 4 main panes

🐶 Code Puppy Integration

This setup is designed for Code Puppy — an AI code agent. When enabled, it auto-launches Code Puppy in 4 panes, giving you a multi-agent development environment.

📄 License

MIT — do whatever you want with it! 👻