yuuichieguchi/Calyx

A native macOS terminal app built on Ghostty for running and supervising coding agents

Calyx – AI‑agent‑aware terminal for macOS

What it is – Calyx is a native macOS terminal application that lets you run multiple coding agents (Claude Code, Codex, OpenCode, Hermes, Grok, pi, …) side‑by‑side and manage them from a single UI. It adds a supervisory layer on top of the normal shell workflow: a sidebar shows each agent’s live status, an approval inbox centralises permission prompts, and a Mission Map visualises all panes, sub‑agents and their interactions.

Why it matters – When developers use LLM‑powered code assistants, they often have to juggle many terminal windows, answer scattered tool‑call prompts, and manually copy output between agents. Calyx removes that friction by keeping every agent visible, routable, and controllable without leaving the terminal you already know.

Key features

  • Agents Sidebar – live state (working, blocked, idle, done), sub‑agent hierarchy, unread badges, click‑to‑focus.
  • Approval Inbox – one notification‑style panel for all Claude Code, Codex, Grok and pi tool‑call approvals; optional auto‑approve.
  • Mission Map – card‑based overview of all panes, showing directory, Git branch, token usage, current tool, and visual links between agents that edited the same file.
  • Code review integration – Git sidebar with inline diffs, line‑level comments, and a button to submit the review directly to an agent pane.
  • AI Agent IPC (MCP) – built‑in messaging server lets agents discover each other and exchange messages (register_peer, send_message, broadcast, …). Agents can also call language‑server features (lsp_hover, lsp_definition, etc.) via an LSP proxy.
  • Persistent & remote sessions – daemon‑backed terminals survive app quits; a calyx‑session helper lets you attach to sessions on remote SSH hosts.
  • Browser automation – 25 bundled calyx browser commands let agents script a WKWebView tab (click, fill, screenshot, evaluate JS, etc.).
  • Terminal workspace – tab groups, split panes, command palette, GPU‑accelerated rendering via Ghostty, custom themes, liquid‑glass UI, and full‑screen/compose overlay shortcuts.
  • Usage tracking – optional token‑usage telemetry for Claude Code, stored locally (no conversation text) and viewable in a Usage window.

How you use it

  1. Install via Homebrew (brew install --cask calyx) or download the .app from the latest release.
  2. Open Calyx, enable Enable AI Agent IPC in Settings → Agents.
  3. Start any supported coding‑agent CLI in a pane; the sidebar will list it automatically.
  4. When the agent asks to run a tool (e.g., a file‑read or a web request), the request appears in the Approval Inbox for you to allow/deny.
  5. Use the Mission Map (Cmd+Shift+M) to see the whole workspace, drag cards to rearrange, or click a line‑diff comment to send feedback to the agent.
  6. For remote work, deploy calyx‑session on an SSH host, then re‑attach from the Session Browser (Cmd+Shift+B).

Who it’s for – Software engineers who rely on LLM‑based code assistants and want a single, macOS‑native terminal that keeps those assistants coordinated, auditable, and integrated with Git and browser automation. It is macOS‑only (Apple Silicon, macOS 26+).

Links

All information above is taken directly from the repository’s README; no additional features have been inferred.

Related

  • Project
    onevcat/Prowl

    A native macOS command center and terminal designed for running and coordinating multiple AI coding agents in parallel, featuring state tracking and multi-agent workflows.

  • Project
    umputun/agterm

    agterm is a minimal macOS terminal that groups shells into named workspaces and exposes a full control API (`agtermctl`) for scripts and AI agents to create sessions, type commands, split panes, run overlays, and read back output. It integrates optional Claude/Codex skills so agents can manage their own layout and report status, and it supports restoring live sessions after a restart. Distributed as a signed app for Apple‑silicon Macs and via Homebrew.

  • Project
    iAmCorey/kooky

    A minimal, GPU-accelerated terminal for macOS designed for AI coding, featuring one-click agent launchers, workspace management, and integrated SSH/Git worktree support.

  • Project
    YoanWai/agent-manager

    agent-manager is a Go‑based tmux UI that lets developers run, monitor and interact with multiple AI coding agents (Claude, Gemini, Grok, etc.) from a single, mouse‑friendly list, offering quick prompts, diff review, session lifecycle controls and extensive customization.

  • Project
    fynnfluegge/agtx

    A terminal-native agentic development environment that uses a blackboard system to coordinate multiple AI coding agents across a shared Kanban board.