A macOS 26+ native terminal application built on libghostty with Liquid Glass UI.
- 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
Cmd+Shift+P - 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 --
Cmd+Fto search terminal scrollback with match highlighting,Cmd+G/Cmd+Shift+Gto 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
- Claude Code IPC -- MCP server for communication between Claude Code instances across tabs and panes (demo video)
- Ghostty config compatibility -- reads
~/.config/ghostty/config(most keys hot-reload on save; see Settings for Calyx-managed keys) - Auto-update -- Sparkle-based updates for direct downloads (Homebrew installs use
brew upgrade)
| Shortcut | Action |
|---|---|
Ctrl+Shift+] |
Next group |
Ctrl+Shift+[ |
Previous group |
Ctrl+Shift+N |
New group |
Ctrl+Shift+W |
Close group |
| Shortcut | Action |
|---|---|
Cmd+T |
New tab |
Cmd+W |
Close tab |
Cmd+1--9 |
Switch to tab |
Cmd+Shift+] |
Next tab |
Cmd+Shift+[ |
Previous tab |
| Shortcut | Action |
|---|---|
Cmd+D |
Split right |
Cmd+Shift+D |
Split down |
Cmd+Option+Arrow |
Focus between splits |
| Shortcut | Action |
|---|---|
Cmd+F |
Find in terminal |
Cmd+G |
Next match |
Cmd+Shift+G |
Previous match |
Escape |
Close search bar |
| Shortcut | Action |
|---|---|
Cmd+Shift+P |
Command palette |
Multiple Claude Code instances running in different Calyx tabs or panes can communicate with each other via a built-in MCP server.
- Open the command palette (
Cmd+Shift+P) and run Enable Claude Code IPC - Start Claude Code in two or more terminal panes
- Each instance automatically registers as a peer and can send/receive messages
Available MCP tools: register_peer, list_peers, send_message, broadcast, receive_messages, ack_messages, get_peer_status
To disable, open the command palette and run Disable Claude Code IPC.
brew tap yuuichieguchi/calyx
brew install --cask calyx- Download
Calyx.zipfrom the latest release - Unzip the file
- Drag
Calyx.appinto/Applications
Direct downloads include automatic update checking via Sparkle. Homebrew installs are updated via brew upgrade.
- macOS 26+ (Tahoe)
- Xcode 26+
- Zig (version matching ghostty's
build.zig.zon) - XcodeGen (
brew install xcodegen)
# 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 buildCalyx uses AppKit for window, tab, and focus management with SwiftUI for view rendering, bridged via NSHostingView.
- All ghostty C API calls go through the
GhosttyFFIenum @MainActorenforced on all UI and model code- Action dispatch via
NotificationCenter
Tech stack: Swift 6.2, AppKit, SwiftUI, libghostty (Metal), XcodeGen
- 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,font-thicken,minimum-contrast,background-opacity-cells,font-codepoint-mapare overridden by Calyx for Glass UI. See Settings > Ghostty Config Compatibility for the full list.
This project is licensed under the MIT License.
Built on libghostty by Mitchell Hashimoto (MIT License).
