Calyx

Run more coding agents without babysitting more terminals.

Calyx is a native macOS terminal for running and supervising coding agents (Claude Code, Codex, OpenCode, Hermes, Grok, and pi...) in parallel. It keeps every agent visible and controllable with one approval inbox, live status, persistent sessions, agent-readable command history, and inline diff review -- without replacing the terminal workflow you already use.

Documentation · Latest release · MIT license

Demo

Three Claude Code agents run in parallel while Calyx keeps approvals and command output in one control surface (36s):

https://github.com/user-attachments/assets/a04e1161-e296-4791-9b7c-3ef84d990089

Install

Homebrew

brew install --cask calyx

Manual download

1. Download Calyx.zip from the latest release.
2. Unzip it and move Calyx.app to /Applications.

Why Calyx

See which agent needs you

The Agents Sidebar shows every connected agent as working, blocked, idle, or done, and expands a pane into the subagents it is currently running. Unread badges and click-to-focus navigation replace the loop of checking terminal tabs one by one.

Approve tool calls from one inbox

Claude Code and Codex permission prompts, the tool calls of Grok sessions running in always-approve mode, and every pi tool call appear in a macOS-notification-style panel at the top-right of your screen: a primary action plus an Options pull-down listing every other choice the CLI offers, including its own always-allow suggestions. Click the request text to expand its full payload, or hover it to read the full text in a tooltip. A Claude Code AskUserQuestion prompt answers the same way -- pick an option from Options, or from an inline option list when the question allows several answers at once or carries a preview, choose "Other…" to type a free-text answer, add notes, or hand the conversation back to the CLI with "Chat about this" -- and move through pending requests without hunting for the pane that raised them. Enable the integration explicitly in Settings; nothing is automatically approved unless you separately opt in. pi ships no permission prompt of its own, so with the integration off its tool calls run unreviewed.

Review code without leaving the terminal

Inspect working changes and commit history in the Git sidebar, add comments to individual diff lines, and submit the complete review directly to a Claude Code, Codex, OpenCode, Hermes, or Grok pane.

Give agents a terminal they can understand

Calyx exposes panes, commands, captured output, browser tabs, language servers, and peer agents through MCP and its bundled CLI. Agents can coordinate work, wait for commands to finish, and inspect results instead of relying on sleep timers or copied output.

Features

Agent supervision

• Agents Sidebar -- live status for Claude Code, Codex, OpenCode, Hermes, Grok, and pi, with every row named after its own pane (title, working directory, agent), unread badges, last-seen timestamps, and click-to-focus navigation
• Subagent Rows -- a pane running subagents gains a count badge and a disclosure chevron that expands them as indented child rows, for the CLIs that report subagents (Claude Code, Codex, OpenCode, Grok); each row carries the child's state, and the child's current tool with the command, path, or URL that call is working on wherever its CLI reports one (Claude Code and Grok; Codex and OpenCode report lifecycle only). Children exist only while the CLI reports them, and a pane whose CLI reports no subagents at all (pi, Hermes, herdr) looks exactly as it always did. Because a CLI reads its hook configuration once at session start, subagent rows appear in sessions started after Calyx installs the hooks, not in one already running
• Approval Inbox -- one opt-in queue across every pane for Claude Code and Codex permission prompts, for the tool calls of always-approve Grok sessions, and for every pi tool call, shown in a notification-style panel with a primary action and an Options pull-down for every other choice (including Allow, Deny, and per-pane or global session-scoped approval), or an inline option list when the question allows several answers at once or carries a preview; Claude Code and Codex queue a request only where the CLI would have prompted you itself and fall back to the agent's own prompt, while an unanswered Grok or pi request is denied
• Approval Queue Navigation -- inspect and decide pending requests in any order, with a preview menu on the position label for jumping straight to one, and automatic navigation to the nearest remaining request
• Dismiss -- the panel's own × is offered only when the CLI's own prompt, or the calling MCP agent, can still decide the request without Calyx: it hands a Claude Code or Codex tool call back to that CLI's own confirmation prompt, or reports a no-decision result to a Calyx MCP tool's own caller. Grok and pi requests must be answered in Calyx -- its own decision is their only gate, so the × is disabled for them
• Agent Cockpit -- MCP tools for listing, creating, and splitting panes; commands and keystrokes remain approval-gated unless auto-approve is enabled
• Command Log -- structured commands, working directories, exit status, and captured output exposed to agents through MCP; known secret patterns are redacted before exposure

Code review and agent coordination

• Git Source Control -- working changes, staging state, commit graph, branch visualization, and inline diffs in the sidebar, as one collapsible section per repository the window can reach, including linked worktrees and checked-out submodules
• Commit Log Ref Picker -- the commit graph uses an Auto scope modelled on VSCode's (the checked-out branch, its upstream, and the remote's default branch), with a per-repository picker for all references or any set of branches, remotes, and tags, and branch and tag badges on commit rows
• Diff Review Comments -- comment on individual lines and submit a complete review directly to an agent pane (demo video)
• AI Agent IPC -- built-in MCP messaging lets agents discover and communicate with peers across tabs and panes (demo video)
• LSP Proxy MCP -- hover, definition, references, rename, diagnostics, and other language-server features for agents; missing servers can be installed from Settings

Sessions and remote work

• Persistent Sessions -- opt-in daemon-backed terminals survive app quit and crashes, with a Session Browser, recovery flow, and optional on-disk history
• Remote Sessions -- deploy calyx-session once to an SSH host from ~/.ssh/config, then browse and reattach to remote persistent sessions
• Agent Resume -- offer to resume the agent CLI conversation associated with a reattached session
• Layout Restore -- restore tabs, splits, and working directories on launch
• herdr Integration -- browse and manage herdr workspaces as native split-pane tabs; herdr-hosted agents also appear in the Agents Sidebar, and a row bridged into a Calyx tab focuses that pane on click. Calyx watches for herdr instead of polling, so herdr started or installed after Calyx launched is picked up without a relaunch

Terminal workspace

• libghostty Engine -- Metal GPU-accelerated rendering powered by Ghostty v1.3.1
• Tab Groups and Split Panes -- color-coded collapsible groups, tab renaming and reordering, horizontal and vertical splits, directional focus, and split zoom
• Tab Context Menu -- right-click or Ctrl+click a tab in the tab bar or sidebar to close it, close the other tabs or the tabs to its right in its group, or rename it, without switching to it
• Command Palette -- search and run operations with Cmd+Shift+P
• Ghostty Compatibility -- read ~/.config/ghostty/config, hot-reload most settings, and bind Calyx operations through Ghostty keybind actions
• Search and Navigation -- highlighted scrollback search, native overlay scrollbar, smooth trackpad and mouse-wheel scrolling, and prompt-line cursor click-to-move
• Input Tools -- shell-escaped drag and drop, multiline Compose Overlay, clipboard safety confirmation, and Secure Keyboard Entry
• Quick Terminal and Notifications -- a system-wide drop-down terminal plus OSC 9/99/777 desktop notifications
• Liquid Glass Appearance -- macOS 26-native glass UI drawn as one seamless sheet of window chrome, eight theme presets, custom colors, adaptive text color, an optional opacity pass that reaches cells an app paints itself, and a fully opaque window under Reduce Transparency (demo video)

Browser automation

• Browser Tabs -- non-persistent WKWebView tabs alongside terminal tabs, limited to http and https with popups blocked
• Scriptable Browser -- 25 bundled calyx browser commands for accessibility snapshots, clicking, filling, evaluation, screenshots, waits, and inspection

Keyboard Shortcuts

Group Operations (Ctrl+Shift)

| Shortcut | Action | |---|---| | Ctrl+Shift+] | Next group | | Ctrl+Shift+[ | Previous group | | Ctrl+Shift+N | New group | | Ctrl+Shift+W | Close group |

Tab Operations (Cmd)

| Shortcut | Action | |---|---| | Cmd+T | New tab | | Cmd+W | Close focused pane (whole tab if nothing narrower to close) | | Cmd+Option+W | Close tab | | Cmd+Shift+W | Close window | | Cmd+Shift+Option+W | Close all windows | | Cmd+1--9 | Switch to tab | | Cmd+Shift+] | Next tab | | Cmd+Shift+ | Previous tab |

calyx browser list                         # List all browser tabs
calyx browser snapshot --tab-id <id>       # Accessibility tree with element refs
calyx browser get-text h1 --tab-id <id>    # Get element text
calyx browser click a --tab-id <id>        # Click element
calyx browser fill input --value "text"    # Fill input field
calyx browser eval 'document.title'        # Execute JavaScript
calyx browser screenshot                   # Capture to temp file
calyx browser wait --selector ".loaded"    # Wait for condition
calyx browser get-attribute a href         # Get element attribute
calyx browser get-links                    # List all links (JSON)
calyx browser get-inputs                   # List all form inputs (JSON)
calyx browser is-visible '#sidebar'        # Check element visibility
calyx browser hover '#menu-item'           # Hover over element
calyx browser scroll down --amount 500     # Scroll page/element

• macOS 26+ (Tahoe)
• Xcode 26+
• [Zig (version matching ghostty's build.zig.zon)
• XcodeGen (brew install xcodegen)

Building

# Clone with submodules
git clone --recursive https://github.com/yuuichieguchi/Calyx.git
cd Calyx
Build libghostty xcframework
cd ghostty
zig build -Demit-xcframework=true -Dxcframework-target=native
cd ..
Copy framework
cp -R ghostty/macos/GhosttyKit.xcframework .
Generate Xcode project & build
xcodegen generate
xcodebuild -project Calyx.xcodeproj -scheme Calyx -configuration Debug build

Architecture

Calyx uses AppKit for window, tab, and focus management with SwiftUI for view rendering, bridged via NSHostingView.

• All ghostty C API calls go through the GhosttyFFI enum
• @MainActor enforced on all UI and model code
• Action dispatch via NotificationCenter

Contributing

Bug reports and feature ideas are welcome as issues. External pull requests are not accepted. See CONTRIBUTING.md.

Known Limitations

• Cursor click-to-move on full-width text -- cursor placement may be offset on Japanese/full-width text lines because Ghostty's cursor-click-to-move internally translates clicks into arrow-key steps over terminal cells.
• Calyx-managed config keys -- background-opacity, background-blur, background-opacity-cells, font-codepoint-map, foreground are overridden by Calyx for Glass UI. background-opacity-cells is set from Settings > Appearance > Glass instead. See Settings > Ghostty Config Compatibility for the full list.

License

This project is licensed under the MIT License.

Acknowledgements

Built on libghostty by Mitchell Hashimoto (MIT License).