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.

Stars
★ 365
Last updated
24d ago
License
MIT
Primary language
Swift

At a glance

How it runs
Desktop appCLI
Works with
Platform-specificCodex · Claude Code
Cost
Free, no paid service needed
Setup effort
Low · running in minutes
You'll need
macOS 26 Tahoe or laterXcode 26+Zig (matching ghostty's build.zig.zon)XcodeGen (for building from source)Shell / CLINetwork accessLocal filesystemMCP Server
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.

  1. A developer running three Claude Code instances in parallel who wants every permission prompt in one approval inbox instead of cycling through terminal tabs
  2. 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
  3. A code reviewer who wants to comment on individual diff lines and submit the complete review directly to a Claude Code or Codex pane
  4. 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
  5. Remote workers who need sessions to survive crashes: enable daemon-backed persistent sessions or deploy calyx-session to an SSH host and reattach remotely
  6. 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?

Pros
  • 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
Limitations
  • 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?

FollowAgents source review · FARS-2.1
Some gaps
72/ 100 5-point scale 3.6 / 5
Trust 18/29
Reliability 9/14
Adaptability 16/18
Convention 13/18
Effectiveness 12/13
Verifiability 4/8
Why each dimension lost points
Trust18 / 29 · 3.1/5

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.

Reliability9 / 14 · 3.2/5

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.

Adaptability16 / 18 · 4.4/5

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.

Convention13 / 18 · 3.6/5

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.

Effectiveness12 / 13 · 4.6/5

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.

Verifiability4 / 8 · 2.5/5

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.

Risks and how to mitigate them
  • 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.
Evidence confidence: Low Reviewed Nov 07, 2026 Reviewed revision 2dfb7a400d45
See the full review method →
Maintain this project? Add the FARS badge to your README

The badge shows the current review score and verdict and links back to this page. It refreshes about once an hour after a re-review.

FARS

[![FARS review](https://followagents.com/badge/calyx.svg)](https://followagents.com/en/agents/calyx)
<a href="https://followagents.com/en/agents/calyx"><img src="https://followagents.com/badge/calyx.svg" alt="FARS review"></a>

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. 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 ↗
  2. 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 ↗
  3. 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?
No. The integration must be enabled explicitly in Settings, and no request is approved automatically without your separate opt-in; Claude Code and Codex queue a request only where the CLI would have prompted you itself.
Which agent CLIs does it support?
The README lists Claude Code, Codex, OpenCode, Hermes, Grok, and pi—all appear in the Agents Sidebar and can join the built-in MCP IPC—though capabilities like subagent reporting and approval gating differ per CLI.
Can command logs leak secrets to agents?
Calyx redacts known secret patterns (tokens, passwords, API keys, JWTs) from command text and output before exposing them; output still being redacted reports output_pending: true.
Do sessions die when the app quits?
Not if you enable the opt-in daemon-backed persistent sessions, which survive app quit and crashes and include a Session Browser, recovery flow, and optional on-disk history.
Can I contribute code?
The project welcomes bug reports and feature ideas as issues, but does not accept external pull requests (see CONTRIBUTING.md).
Is Calyx free?
Yes. Calyx is free to use and does not need a paid service.
Is Calyx open source?
Yes. The source code is on GitHub (yuuichieguchi/Calyx) under the MIT licence.
Is Calyx safe to use?
FollowAgents' FARS review (Nov 07, 2026) scored Calyx 18/29 on trust and safety. None of the eight safety controls the review checks for was missing outright.
Is Calyx still maintained?
Yes. The latest commit on GitHub is from 2026-10-23, within the last 30 days. The latest release is v0.50.1 (2026-10-23).
Who makes Calyx?
Calyx is published on GitHub by the account yuuichieguchi. FollowAgents has not verified which person or company is behind that account.
What is Calyx's official website?
The project's GitHub repository lists https://getcalyx.app/ as its website. That link is set by the repository owner; the source code itself is on GitHub (yuuichieguchi/Calyx).
Was this page helpful?
View on GitHub ↗ Install ↓

Host ecosystems

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related concepts