yuuichieguchi / Calyx

Calyx A macOS 26+ native terminal application built on libghostty with Liquid Glass UI. Features • **libghostty terminal engine** -- Metal GPU-accelerated rendering via Ghostty v1.3.0 submodule • **Liquid Glass UI** -- native macOS 26 Tahoe design language • **Tab Groups** -- 10 color presets, collapsible sections, hierarchical organization • **Split Panes** -- horizontal and vertical splits with directional focus navigation • **Command Palette** -- search and execute all operations with • **Session Persistence** -- tabs, splits, and working directories auto-saved and restored on restart • **Desktop Notifications** -- OSC 9/99/777 support with rate limiting • **Browser Integration** -- WKWebView tabs alongside terminal tabs (http/https only, non-persistent storage, popup blocking) • **Scrollback Search** -- to search terminal scrollback with match highlighting, / to navigate matches • **Native Scrollbar** -- system overlay scrollbar for terminal scrollback • **Cursor Click-to-Move** -- click on a prompt line to reposition cursor (requires shell integration) • **Git Source Control** -- sidebar Changes view with working changes (staged/unstaged/untracked), commit graph with branch visualization, and inline diff viewer • **AI Agent IPC** -- MCP server for communication between AI agent instances (Claude Code, Codex CLI) across tabs and panes (demo video) • **Scriptable Browser** -- 25 CLI commands for browser automation (like cmux): snapshot, click, fill, eval, screenshot, wait, get-attribute, get-links, get-inputs, is-visible, hover, scroll. No enable step needed. CLI bundled in the app • **Ghostty config compatibility** -- reads (most keys hot-reload on save; see Settings for Calyx-managed keys) • **Auto-update** -- Sparkle-based updates for direct downloads (Homebrew installs use ) Keyboard Shortcuts Group Operations (Ctrl+Shift) | Shortcut | Action | |---|---| | | Next group | | | Previous group | | | New group | | | Close group | Tab Operations (Cmd) | Shortcut | Action | |---|---| | | New tab | | | Close tab | | -- | Switch to tab | | | Next tab | | | Previous tab | Split Operations | Shortcut | Action | |---|---| | | Split right | | | Split down | | | Focus between splits | Search | Shortcut | Action | |---|---| | | Find in terminal | | | Next match | | | Previous match | | | Close search bar | Global | Shortcut | Action | |---|---| | | Command palette | IPC (Inter-Pane Communication) AI agent instances (Claude Code, Codex CLI) running in different Calyx tabs or panes can communicate with each other via a built-in MCP server. • Open the command palette ( ) and run **Enable AI Agent IPC** • Start agents (Claude Code, Codex, or both) in two or more terminal panes • Each instance automatically registers as a peer and can send/receive messages Config is auto-written to and when the respective tool is installed. Restart running agent instances to pick up the new MCP server. Available MCP tools: , , , , , , To disable, open the command palette and run **Disable AI Agent IPC**. Browser Scripting Agents can programmatically control browser tabs via 25 CLI commands, similar to cmux's browser automation. • Open a browser tab and navigate to a page • Use commands from any terminal tab — no enable step needed CLI Commands The CLI binary is bundled inside . To install it to your PATH, run **Install CLI to PATH** from the command palette. The browser server starts automatically with the app and listens on . Connection info is written to . Installation Homebrew Manual • Download from the latest release • Unzip the file • Drag into Direct downloads include automatic update checking via Sparkle. Homebrew installs are updated via . Building from Source Prerequisites • macOS 26+ (Tahoe) • Xcode 26+ • Zig (version matching ghostty's ) • XcodeGen ( ) Building Architecture Calyx uses AppKit for window, tab, and focus management with SwiftUI for view rendering, bridged via . • All ghostty C API calls go through the enum • enforced on all UI and model code • Action dispatch via **Tech stack**: Swift 6.2, AppKit, SwiftUI, libghostty (Metal), XcodeGen 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** -- , , , , , are overridden by Calyx for Glass UI. 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).