iTerm2
Works out of the boxExact tab and pane focus, text injection, hold-to-interrupt, and Minimize Window. macOS asks once for Automation and Accessibility permission.
Terminal setup · macOS and Windows
Your session. Exactly where you left it.
For the strongest all-round control, use iTerm2 on macOS or Windows Terminal x64 on Windows. Ghostty 1.3+ and WezTerm are also strong macOS choices; tmux adds reliable exact-pane control inside other terminals.
Works out of the boxInstall VibeDeck and approve macOS permissions when asked.
One-time setupA quick opt-in unlocks exact session control.
App focus onlyVibeDeck opens the app and types where the terminal allows it.
Ready immediately
Nothing to configure.
Start your agent normally. The first time VibeDeck controls another app, macOS may ask for Automation or Accessibility access.
Ghostty 1.3+
Native controlNative focus, text entry, submit, clear, interrupt, and session resume through Ghostty’s AppleScript interface. Matching is exact when one pane owns the agent’s working directory; all failed or ambiguous matches stop safely. Minimize Window is unavailable because Ghostty does not expose a verifiable Accessibility window identity.
Terminal.app
Works out of the boxExact tab focus and typing after you grant Accessibility permission.
tmux inside any terminal
Works out of the boxAutomatic and the most reliable path. When the agent session runs inside tmux, VibeDeck injects through tmux itself — even when the pane is in a background window. Hold-to-interrupt is included. No setup.
Best fallback: If your terminal cannot expose individual tabs or panes, run the agent inside tmux to get full injection support.
WezTerm
Works out of the boxExact pane focus and text injection when VibeDeck captures a usable pane ID and the bundled wezterm CLI is available. Otherwise it falls back to app focus and foreground typing. Minimize Window is unavailable because the pane ID does not verify its containing macOS window.
One-time opt-in
Give kitty exact control.
kitty keeps remote control off by default. Add two settings, then restart the app completely.
- 1
Open kitty’s config
Open
~/.config/kitty/kitty.confin your editor. Create it if it does not exist. - 2
Add the remote-control socket
Copy both lines exactly.
~/.config/kitty/kitty.confallow_remote_control yes listen_on unix:/tmp/kitty - 3
Quit kitty fully and reopen it
Close the application, not just its windows. New sessions now get exact window focus and text injection.
Minimize Window is unavailable: kitty’s terminal ID does not verify the containing macOS window. Without remote-control opt-in, kitty still gets app focus and keystrokes.
VS Code and Cursor terminals
The companion bridge can target an exact integrated terminal; without it, VibeDeck uses app focus and the foreground terminal. Minimize Window is unavailable because the containing editor window cannot be verified. The bridge is not currently distributed as a download.
Graceful fallback
Focus the app, then type.
These terminals do not currently expose enough automation for exact per-tab control. VibeDeck uses the best path each app makes available.
Warp
App focus onlyApp focus and foreground typing. Strict Minimize Window targeting is unavailable; use tmux for exact pane control.
Alacritty
App focus onlyApp focus and foreground typing. Strict Minimize Window targeting is unavailable; use tmux for exact pane control.
Unknown terminals
Use tmuxStatus monitoring still works, but focus, typing, and strict minimization need a known integration. Run the agent inside tmux for reliable exact-pane control.
Windows
Windows Terminal x64
Verified exact tab focus and typing with captured session identity. Minimize Window remains pending until the rebuilt x64 helper ships. Elevated tabs, ARM64, and other Windows terminals are not supported.
Next step