betterterm

Terminal IDE setup: Ghostty + tmux + yazi + carbonyl browser.

Install

npx betterterm@latest

Requirements

• macOS with Homebrew
• Ghostty terminal emulator

The installer handles everything else (tmux, yazi, carbonyl).

What it does

• Installs tmux, yazi, and carbonyl via Homebrew/npm
• Configures tmux with a clean status bar, mouse support, and keybindings
• Sets up yazi as a toggleable file explorer with cd-to-terminal sync
• Adds an in-terminal browser (carbonyl) toggled via hotkey
• Patches your Ghostty config with Cmd-key shortcuts that map to tmux
• Layout presets (1-4 panes) with auto-launch of Claude Code
• Agent-aware status bar showing running AI agents per pane
• Project session save/restore
• Broadcast mode, pane zoom, and directional pane swapping

Keybindings

| Key | Action | |-----|--------| | Cmd+E | Toggle file explorer (yazi) | | Cmd+Y | Toggle browser (carbonyl) | | Cmd+Shift+Y | Close browser | | Cmd+L | Browser URL bar | | Cmd+T | New tmux window | | Cmd+] | Next window | | Cmd+[ | Previous window | | Cmd+\ | Split pane vertically | | Cmd+- | Split pane horizontally | | Cmd+Arrow | Resize pane | | Cmd+R | Reload tmux config | | Ctrl+B, Tab | Toggle between panes |

Layout & Agents

| Key | Action | |-----|--------| | Cmd+1 | Focus mode (1 pane + claude) | | Cmd+2 | Dual mode (2 panes + claude) | | Cmd+3 | Triple mode (3 panes + claude) | | Cmd+4 | Quad mode (4 panes + claude) | | Cmd+Z | Zoom pane toggle | | Cmd+Shift+B | Broadcast toggle (type in all panes) | | Cmd+S | Save session | | Cmd+O | Load session | | Cmd+Shift+Arrow | Swap pane position | | Cmd+? | Help menu (clickable) |

Uninstall

The installer backs up any existing configs to *.backup files. To revert:

# Restore configs
mv ~/.tmux.conf.backup ~/.tmux.conf
mv ~/.config/yazi/yazi.toml.backup ~/.config/yazi/yazi.toml
mv ~/.config/yazi/keymap.toml.backup ~/.config/yazi/keymap.toml

# Remove betterterm block from Ghostty config (between the marker comments)
# Remove scripts
rm ~/.local/bin/betterterm*.sh ~/.local/bin/toggle-*.sh ~/.local/bin/open-browser.sh ~/.local/bin/close-browser.sh ~/.local/bin/browser-nav.sh ~/.local/bin/layout.sh ~/.local/bin/session-*.sh ~/.local/bin/swap-pane.sh

License

MIT