Run Claude Code, Codex CLI, OpenCode, and Antigravity CLI side by side in a native macOS terminal — with live per-agent state, project-aware panes, rendered Markdown & PDF previews, and updates that don't end your sessions.
Press ⌘G to jump straight to the next WAIT agent.
Running N coding agents — Claude Code, Codex CLI, OpenCode, Antigravity CLI, or any mix — in a stock terminal turns into tab roulette: you Cmd-Tab through windows, scan panes, miss the one waiting on you.
termy pulls that state out of the panes and into a glanceable dashboard.
Every running agent gets a chip at the bottom showing live status —
IDLE,
THINK,
WAIT, or
ERR.
The moment an agent needs permission or input, macOS notifies you — even when termy is in the background — and ⌘G jumps you straight to that pane.
Every pane is grouped by its cwd into a project. Same project gets the same jewel-tone accent — pane header, dashboard chip, filter pill — all the way through. Drag the titlebar chips to put projects in your order, and the ⌘K list lets you remove folders you renamed or deleted without ever touching the folder itself. A four-agent window stops looking like a soup of identical black rectangles and turns into something you can read at a glance.
Numbered pills appear on the top filter bar. ⌘0 shows all, ⌘1–⌘9 jump to that project's pane grid in one keystroke, and ⌘⇧[ / ⌘⇧] walk the filters in order.
Fuzzy-match across every project termy has ever seen — pane counts and last-used timestamps included. Pick one and termy rebuilds the saved pane grid you left it in. Stale rows have a trash button, or press ⌘⌫ with an empty search. Only termy's saved layout is forgotten.
Every running agent — Claude Code, Codex CLI, OpenCode, or Antigravity CLI, mixed freely — gets one chip in the bottom strip, showing project / branch and live state. While an agent works, a bar in the project's color slides along its pane header. Hold ⌘⌥ for numbered badges so you can jump directly to a chip. Open several windows and each strip shows chips for every window at once — click one and termy brings the owning window forward and focuses the pane. Tapping a WAIT notification does the same.
The agent is at the prompt with nothing running.
A tool call is in flight. The model is doing work.
Blocked on a permission prompt or a question. Your attention needed.
The agent or its shell exited with an error. The chip stays red until you look.
⌘G jumps to the next
WAIT pane — across splits, across project
filters, across windows. ⌘⌥G walks every dashboard
chip in order. Fresh panes start as INIT
until the agent reports its first event.
Pane border, sliding header activity bar, dashboard chip, and a macOS notification — driven by each agent's own hooks and plugins: Claude Code, Codex, OpenCode, and Antigravity.
Real splits backed by nested NSSplitView.
Drag to resize. ⌘T adds a pane (auto-orients on aspect ratio),
⌘D splits the current row, ⇧⌘D adds a new row.
The full shortcut map — panes, focus, projects, appearance, window. No hidden bindings.
Light, Dark, or Match System — View → Appearance or ⌘⇧T switches the terminal, chrome, and dashboard together. ⌘, picks the terminal font, Korean fallback, and size.
⌘-click a Markdown or PDF path in any pane — a spec an agent just wrote, a plan, a generated report —
and termy opens it in its own preview window. Drop a file on a preview window to do the same.
Previews follow your light or dark appearance and update live as the agent writes.
PDF links inside a Markdown preview, and
file:// links to PDFs,
open there too — even when the filename has spaces or parentheses.
Tables, task lists, and code blocks look the way they do on GitHub. When an agent edits the file, the preview updates in place and keeps your scroll position. ⌘W closes the preview without touching your panes.
Open a PDF path the same way. A regenerated file updates the preview while keeping the page and zoom you were reading; a half-written file leaves the previous version on screen. ⌥⌘R shows the file in Finder.
Claude Code, Codex CLI, OpenCode, and Antigravity CLI — mixed freely in the same window.
Each integration installs from the termy menu and reports live state through hooks or a plugin.
A WAIT flip pings macOS even when termy is in the background.
Splits, project grouping, and cwd are all persisted per project. Pick a project in ⌘K and termy rebuilds the pane grid you left it in.
Install and Relaunch waits while an agent is mid-turn, then resumes the same conversation
with claude --resume or codex resume — flags included.
In a hurry, choose termy ▸ Restart Now to Install Update.
⌘N opens an independent window — its own pane grid, project filter, and split behaviour. Fan agent work out across every display.
Relaunch and every window returns — frames, positions, pane layouts, and project filters. A window stranded off-screen is clamped back onto a visible display.
Turn on Settings… ▸ Run local panes in herdr-core and panes run inside herdr-core instead of a PTY termy owns. Quit termy or install an update and Claude Code keeps working; the next launch puts each pane back on the same terminal, same screen and process. Off by default — termy offers to install herdr-core when it is missing.
⌘K ▸ New Remote Project… opens a folder on another machine you added with
hc machine add. Panes read <folder>@<machine>, splits open on
the same machine, and its agents show up in the dashboard like local ones.
⌘T new pane, ⌘D same-row split, ⇧⌘D new-row split. Drag the dividers. ⌘⏎ toggles maximize.
Drop files from Finder onto a pane and termy types the absolute paths, escaped and ready for zsh. ⇧⏎ inserts a newline in Claude Code instead of submitting the prompt.
Clicks and drags go to apps that use the mouse — Claude Code fullscreen, tmux, vim — the way Ghostty and iTerm2 do. Hold ⇧ to select with termy instead, and the selection survives scrolling.
Trackpad scrolling moves by the distance you swipe, with Ghostty-style momentum;
a mouse wheel moves three rows a notch. Scrollback stops snapping to the bottom while you
read, and follows again once you scroll back down. Tune the speed with
termy.scrollSensitivity.
Pick a monospaced font, a Korean fallback, and a size — changes apply live. ⌘⇧T cycles System / Light / Dark. Korean IME composition and circled numbers like ①②③ no longer cover the line.
Drag titlebar chips to reorder projects; the order drives ⌘1–⌘9, the ALL view, and focus order. ALL packs panes into one even grid with each project's panes kept together, while a single project keeps the split layout you built. Remove folders you renamed or deleted from the ⌘K list — the folder itself is never touched.
AppKit + SwiftTerm. A signed, notarized DMG,
real UserNotifications, Full Disk Access, titlebar chrome — and Sparkle
updates that verify every build.
Move through N panes without ever touching the trackpad.
Four agents' hook surfaces, one tiny CLI helper, and an in-app actor cooperate to produce the state.
Claude Code ──hook───▶ termy-hook --agent claude-code ───┐ Codex CLI ──hook───▶ termy-hook --agent codex ───┤ OpenCode ──plugin─▶ termy-hook --agent opencode ───┼──unix socket──▶ HookDaemon (in-app actor) Antigravity ──hook───▶ termy-hook --agent antigravity ───┘ │ ┌─────────┴─────────┐ ▼ ▼ PaneStateMachine fg-process watcher │ (synthetic SessionStart/End) ▼ MissionControlView + Notifier
/tmp/termy-$UID.sock. It always exits 0 and times out writes after 100 ms, so it cannot stall an agent.tui.js watches the active session's permission, question, and busy flags and reports transitions; termy maps them to IDLE, THINK, WAIT, and ERR. Installing it adds one file, and OpenCode sessions that are already open pick it up right away.~/.gemini/config/hooks.json, they report the same states and let termy reopen the same conversation with agy --conversation after an update.claude or codex leaves a pane.Notification hook the moment it stops for input; Codex doesn't. PermissionRequest only fires for explicit asks, not the general "I'm waiting on you" pauses reasoning models lean on. termy fills the gap with a two-stage silence detector (~8 s → silent POSSIBLY_WAITING, ~12 s → WAITING + sound). Trade-off: Codex WAIT lands ~20 s after the agent paused, not instantly.termy-hook + non-destructive installers for every integration