Wormhole

Four agents running, and one has been waiting on you for ten minutes. In a row of tabs you find out by clicking through them.

In Wormhole every terminal is a row in a sidebar, and each row says what is going on there: working, finished, or waiting for you, with the question the agent asked. A terminal with nothing to report says nothing. Next to the terminal are its git changes and history, so you can read what an agent did before you commit it, without leaving for another app.

It works with Claude Code, Codex, Gemini CLI, Cursor Agent and others, and it is just as happy as a plain terminal with no agent at all.

What you get

• A sidebar instead of tabs. Group terminals, name them, color them, jump to one with ⌘1 to ⌘9. A folded group still shows when one of its terminals needs you. If you prefer tabs along the top, that's a setting.
• Status from the agents themselves. Wormhole recognizes fifteen agents by the program running in the terminal. Eight of them, Claude Code and Codex among them, report their status directly once you install their hooks in Settings → Coding agents; for the rest, Wormhole goes by the output and the bell. Nothing is installed until you press Install.
• The diff next to the terminal. Changed files as a list or a tree, syntax-highlighted diffs side by side or inline, a comparison with any branch, and the branch's history.
• Splits, worktrees, profiles. Split with ⌘D, give an agent a git worktree of its own, and keep Work and Private apart: each profile has its own terminals, theme, git identity and Claude and Codex logins.
• Away from the window. Notifications, the Dock badge, a menu bar item and a quick panel with a global hotkey, so you can answer an agent without switching apps.
• A terminal underneath. Command blocks with exit codes and timings, inline images (kitty, iTerm2, Sixel), search, a minimap, and themes: Ghostty, iTerm2 and Alacritty themes import, and the Theme Studio edits every color.
• Quit and come back. Windows, folders and the last 2,000 lines of each terminal come back, encrypted on disk. Shells start fresh.

Everything is on the keyboard: ⇧⌘P opens the command palette and ⌥⌘/ lists every shortcut, as does the website.

How it's built

Wormhole is a native app written in Rust, drawn with GPUI, the UI framework of the Zed editor. It is not a web view. Wormhole has no AI of its own: no model, no API key, no account. It runs the agents you already use.

The terminal engine, wormhole-vt, is Wormhole's own: written from the specifications and published separately under the MIT license. Agents print a lot and builds print more; the window keeps up. How it compares with Ghostty, kitty, WezTerm, iTerm2, Alacritty and Terminal.app, including where they're ahead, is on the compatibility page.

macOS only, for now. There is no Windows or Linux version.

Install

Wormhole needs macOS 14 (Sonoma) or later and runs on Apple silicon and Intel.

Download the disk image from getwormhole.app, drag Wormhole into Applications and open it from there; it can't update itself from the disk image or Downloads. It is signed with a Developer ID and notarized by Apple.

With Homebrew:

brew install --cask wormhole-terminal/tap/wormhole-terminal

Or build it yourself, below.

Build from source

You need macOS 14 or later, Rust (the version is pinned in rust-toolchain.toml) and the Xcode command line tools.

cargo run --release

For development:

scripts/dev.sh            # rebuild on changes
scripts/check.sh          # run checks for the changed files
cargo test -p wormhole-core

The app lives in crates/wormhole; configuration, storage, git and agent integrations live in crates/wormhole-core. See CONTRIBUTING.md for the checks, the tests and how we write commits.

Privacy

Wormhole has no analytics, no crash reporting and no account, and your settings and terminal output stay on your Mac. In 1.3 an update check sends the app version and nothing else.

From version 1.4, not released yet, a check also sends the update channel, Apple silicon or Intel and the macOS major version, and the first check each day and each month is marked, so we can count how many copies run. There is no ID, and the server keeps those counts, not your IP address: its code is in tools/feed-counter. Counting starts a day after 1.4 first runs, and Settings → Updates → Count this Mac anonymously shows what is sent and turns it off.

Feedback

Report a bug or use Discussions for questions and ideas. Report security vulnerabilities privately through GitHub security advisories; see SECURITY.md.

License

Wormhole is free software under the GNU GPL v3.0 or later. wormhole-vt is MIT-licensed. Bundled fonts, themes, icons and dependencies retain their own licenses; see About → Licenses in the app.