Calyx
A native macOS terminal for running and supervising coding agents like Claude Code and Codex in parallel, with one approval inbox instead of babysitting terminal tabs.
- Source repo
- yuuichieguchi/Calyx
- Stars
- ★ 365
- Last updated
- 24d ago
- License
- MIT
- Primary language
- Swift
- FA score
- 72/100 · Some gaps
At a glance
- How it runs
- Works with
- Platform-specificCodex · Claude Code
- Cost
- Free, no paid service needed
- Setup effort
- Low · running in minutes
- You'll need
- Typical use
- A developer running three Claude Code instances in parallel who wants every permission prompt in one approval inbox instead of cycling through terminal tabs
- Not a fit if
- Users on macOS 15 or earlier, or on non-Apple-Silicon Macs
- Contributors who need to submit external pull requests
- Teams that need a fully offline setup with no cloud model services
- Website
- getcalyx.app ↗ set on GitHub
- Maintenance
- Commits in the last 30 dayslast commit 2026-10-23latest release v0.50.1 (2026-10-23)+0.7 ★/day over 7 days
- Source review
- 72/100 · Some gaps
What does this agent do, and when should you use it?
Calyx is a native macOS 26 terminal application built on Ghostty v1.3.1 (libghostty with Metal GPU rendering) for running and supervising multiple coding agent CLIs—Claude Code, Codex, OpenCode, Hermes, Grok, and pi—in parallel. An Agents Sidebar shows live per-pane status for every connected agent, while a unified Approval Inbox surfaces Claude Code and Codex permission prompts and Grok/pi tool calls in a macOS-notification-style panel. A built-in Git sidebar offers working changes, commit graph, branch visualization, and line-level diff comments that can be submitted directly to an agent pane. An embedded MCP server exposes pane control, redacted command logs, LSP language-server features, and cross-pane IPC messaging to agents, and 25 calyx browser CLI commands enable browser automation. The app is written in Swift 6.2 with AppKit and SwiftUI bridged via NSHostingView, installs via Homebrew, and updates through Sparkle.
Calyx drives Metal-accelerated terminal rendering through the libghostty C API (wrapped in the GhosttyFFI enum), with tab groups, split panes, a command palette (Cmd+Shift+P), and hot-reloaded support for ~/.config/ghostty/config. On setup it writes MCP/hook configuration into detected agent CLIs' config files (~/.claude.json, ~/.codex/config.toml, ~/.config/opencode/opencode., ~/.hermes/config.yaml, ~/.grok/config.toml, and a TypeScript extension at ~/.pi/agent/extensions/calyx.ts for pi), so each agent instance registers as a peer and can call register_peer, list_peers, send_message, broadcast, receive_messages, and get_peer_status. The same MCP server offers cockpit tools (pane_list, pane_split, tab_create, plus approval-gated pane_run, pane_send_keys, palette_execute), command-log tools (terminal_list_commands, terminal_read_output, terminal_await_command, with known secret patterns like tokens, passwords, and API keys redacted before exposure), and LSP proxy tools (lsp_hover, lsp_definition, lsp_references, lsp_rename, lsp_diagnostics). The Approval Inbox collects permission requests in a top-right notification panel with a primary action plus an Options pull-down, and can hand requests back to the CLI's own confirmation prompt. Opt-in daemon-backed persistent sessions survive app quit and crashes, and the calyx-session binary can be deployed to SSH hosts to browse and reattach remote sessions.
- A developer running three Claude Code instances in parallel who wants every permission prompt in one approval inbox instead of cycling through terminal tabs
- An engineer orchestrating Claude Code, Codex, and OpenCode side by side who needs the sidebar to show at a glance which agent is blocked, working, or done
- A code reviewer who wants to comment on individual diff lines and submit the complete review directly to a Claude Code or Codex pane
- Teams whose agent instances must coordinate: peers discover each other, broadcast messages, and wait for commands to finish via the built-in MCP IPC server
- Remote workers who need sessions to survive crashes: enable daemon-backed persistent sessions or deploy calyx-session to an SSH host and reattach remotely
- Users who want symbol-aware agent tooling: agents call lsp_definition or lsp_diagnostics to get precise results from TypeScript, Python, Rust, and other language servers instead of grep
How do you install or deploy this agent?
Via Homebrew: brew install --cask yuuichieguchi/calyx/calyx. Manually: download Calyx.zip from the latest GitHub release, unzip, and move Calyx.app to /Applications. Requires macOS 26 Tahoe or later; manual installs update via Sparkle and Homebrew installs via brew upgrade. To build from source you need macOS 26+, Xcode 26+, Zig matching ghostty's build.zig.zon, and XcodeGen (brew install xcodegen). Steps: git clone --recursive https://github.com/yuuichieguchi/Calyx.git && cd Calyx && cd ghostty && zig build -Demit-xcframework=true -Dxcframework-target=native && cd .. && cp -R ghostty/macos/GhosttyKit.xcframework . && xcodegen generate && xcodebuild -project Calyx.xcodeproj -scheme Calyx -configuration Debug build.
How do you use this agent?
Launch Calyx and start agent CLIs (Claude Code, Codex, etc.) in terminal panes. Open the command palette (Cmd+Shift+P) and run Enable AI Agent IPC to activate the built-in MCP server (config is auto-written to each CLI's file; restart running agent instances to pick it up—run Reconfigure AI Agent IPC later if you install a new agent). Agents then call the calyx-ipc MCP tools: register_peer, send_message, pane_list, terminal_read_output, and more. Run Install CLI to PATH from the command palette to expose the calyx CLI, then use any of the 25 calyx browser commands (snapshot, click, fill, eval, screenshot, wait) to control browser tabs—the browser server starts automatically on localhost:41840. Enable the approval integration explicitly in Settings; nothing is approved automatically without opt-in. Key shortcuts: Cmd+T new tab, Cmd+D split right, Cmd+F find, Cmd+Shift+U jump to the most recent unread notification tab.
What are this agent's strengths and limitations?
- The unified Approval Inbox gathers Claude Code/Codex permission prompts from every pane into one notification panel, dramatically cutting tab-switching overhead
- More than a terminal: the bundled MCP server provides cross-pane agent IPC, redacted command logs, an LSP proxy, and 25 browser automation commands so agents can perceive panes, output, and symbols
- Built on libghostty (Ghostty v1.3.1) with Metal GPU rendering, it reads and hot-reloads ~/.config/ghostty/config, giving existing Ghostty users a smooth migration path
- Daemon-backed persistent sessions survive crashes, with calyx-session enabling remote SSH session reattachment and agent conversation resume
- Hard requirement of macOS 26 Tahoe or later; older macOS versions and other operating systems cannot run it
- Several capabilities depend on each CLI's own reporting: subagent rows appear only where the CLI reports them (Codex/OpenCode report lifecycle only, not the current tool), and pi tool calls run unreviewed when the integration is off
- Command-log tools (terminal_list_commands, etc.) require the zsh/fish shell integration, and subagent rows only appear in sessions started after Calyx installs its hooks
- Building from source is demanding: Xcode 26+, a version-matched Zig, XcodeGen, and a manual libghostty xcframework build
- External pull requests are not accepted; contributions are limited to issues
How does this agent compare with similar options?
The README explicitly notes that Calyx's browser automation (25 calyx browser commands) is similar to cmux's browser automation, making cmux a named point of comparison.
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| Calyx This agent | 72 · Some gaps | Desktop appFree | ★ 365 | 24d ago | Swift | Codex · Claude Code |
| Claudexor | 76 · Good | CLIFree + model costs | ★ 525 | today | TypeScript | Codex · Claude Code |
| Plannotator | 80 · Good | CLIFreemium | ★ 12k | today | TypeScript | Codex · Claude Code |
| dev-3.0 | 76 · Good | Desktop app | ★ 334 | 1d ago | TypeScript | Codex · Claude Code |
How does FollowAgents rate this agent?
Why each dimension lost points
The README describes approval gates for commands and keystrokes, optional auto-approval, local configuration writes, token renewal, nonce checks, and local data storage, supporting strong user confirmation and data-flow transparency scores. Command logs redact only known secret patterns, usage data remains until the user deletes it, and multiple configuration files are modified automatically; broader sensitive-data policy, rollback details, and dependency-security evidence are limited. Attribution is sparse: the license names a copyright holder, but publisher identity and maintenance responsibility are not verified.
The README gives detailed integration conditions and limitations, with no obvious internal contradiction, but the supplied evidence is largely product documentation rather than implementation or tests, so consistency and availability receive moderate scores. Failure messaging is mentioned for persistent-session kill failures; evidence for other failure paths is limited.
The product clearly targets macOS 26 and Apple Silicon and covers coding-agent supervision, terminal work, parallel sessions, persistent sessions, and remote sessions. It distinguishes supported agent capabilities and setting states, and documents many triggers and limits. Some triggers depend on individual CLI versions and session-start conditions, so they are not fully predictable from the product alone.
The README is organized by feature, installation, shortcuts, and IPC, and provides Homebrew and manual installation paths, extensive examples, and limitations. The MIT license is explicit. Version history is not adequately represented in the supplied material, and publisher maintenance responsibility is unclear. Naming is mostly stable, but the many CLI, component, and entry-point names add some learning cost.
The documented approval queue, status views, diff review, command log, and agent messaging provide actionable supervision and clear value beyond a basic terminal. Setup and maintenance touch multiple CLI configuration files, hooks, extensions, and a local service, while some features require explicit configuration, increasing user effort.
The README makes concrete claims and identifies some assumptions as unverified, but the supplied packet has no corresponding implementation, tests, or release history to corroborate most behavior across sources. Claim-to-evidence traceability is moderate, and fact/inference separation is partial.
- Command logs are documented as redacting known secret patterns only; do not assume every sensitive value is filtered.
- IPC, usage tracking, and agent integrations write to several user-level configuration files. Review the settings and documentation before enabling them, and account for CLI version and session-restart requirements.
- This assessment is based only on the supplied static materials; the application and implementation were not executed or independently verified.
Recent releases
Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.
-
v0.50.1 Calyx v0.50.1
Release notes excerpt
What's Changed Ghostty built-in themes - Calyx now bundles the 463 built-in themes pinned by Ghostty 1.3.1, so theme = <name> in ~/.config/ghostty/config resolves. Previously every built-in theme name was silently ignored. Light/dark themes follow the system appearance (#56) - theme = light:A,dark:B now switches when macOS changes between Light and Dark, in every open pane and in the window chrome. - A config reload applies the variant that matches the current appearance. Session restore …View on GitHub ↗ -
v0.50.0 Calyx v0.50.0
Release notes excerpt
What's Changed Click a notification to jump to its pane - Clicking a Calyx notification now focuses the pane that sent it. Calyx switches to that pane's tab group and tab, closes Mission Map if it is open, restores a minimized window, and brings the window to the front. (#54) - Notifications from a pane are removed from Notification Center once you read its tab (when the unread badge clears), when the pane closes, and when Calyx quits. Pane title as the notification subtitle …View on GitHub ↗ -
v0.49.1 Calyx v0.49.1
Release notes excerpt
What's Changed Diff viewer <img width="1381" height="865" alt="スクリーンショット 2026-10-20 8 54 24" src="https://github.com/user-attachments/assets/dbe662fd-9196-4a99-b15a-4f2c8232d6a7" /> - Right-click or Control-click in the diff body opens a Copy / Select All menu again, and the pointer is an I-beam over text again. 0.49.0 lost both when the diff body moved to a custom-drawn view. - If you right-click outside the current selection, the word under the pointer is selected first, as in standard macOS text views. …View on GitHub ↗
FAQ
Does the approval integration auto-approve agent requests?
Which agent CLIs does it support?
Can command logs leak secrets to agents?
Do sessions die when the app quits?
Can I contribute code?
Is Calyx free?
Is Calyx open source?
Is Calyx safe to use?
Is Calyx still maintained?
Who makes Calyx?
What is Calyx's official website?
Thanks — we use this to improve the page.