A native macOS workspace for coding agents, git worktrees, and parallel development.
Full walkthrough: YouTube
Several tools now run coding agents side by side on macOS. Seahelm shares the obvious parts with them — Swift, libghostty, one git worktree per agent, hooks for status. Three things are its own.
It lives outside the terminal. A multiplexer puts status inside the window you are trying to stop watching. Seahelm's Island sits at the edge of the screen and stays quiet until a worktree needs you, blocked agents raise real system notifications, and you can answer one from your phone over iMessage. Claude and Codex token and quota usage are summarised in-app, so you also see when an agent is about to run out of budget rather than out of ideas.
Built around the decision, not the display. Seahelm reads the agent's final response from the Stop hook and turns an inline next-step marker into clickable cards. First Mate watches status transitions and either handles them or queues them for your approval. Showing "awaiting input" is the easy half; the question is what to do about it.
The conversation forks to where the work goes. When a Claude Code agent creates a
worktree and starts working there, Seahelm forks its conversation into a new pane on
that worktree's card (claude --resume <id> --fork-session): the fork carries on with
the whole transcript, and the original pane stays where it was, its turn stopped and a
note telling it where the work went. Panes are never moved on their own; an agent that
merely visits another worktree only shows where it is in its title, with a button to
fork it there by hand.
Beyond that: native rendering on the Ghostty engine rather than Electron, sessions that outlive the app (and resume their agents after a reboot), and status detection for 12 agents out of the box.
Seahelm is vibe-coded. Nearly every line was written by coding agents — Claude Code and Codex — directed at the level of what should happen, not reviewed diff by diff. It was also built inside itself: the worktrees, split panes and status detection described below were written by agents running in Seahelm's own worktrees, split panes and status detection.
Worth knowing before you install it:
- The code is public and MIT so you can read it instead of taking its word for anything.
- Roughly 1,900 unit tests cover the behaviour that could be specified up front. The paths that could not are where the bugs are.
- A bug report with a reproduction is the single most useful thing you can send. It is what turns a rough edge into a fix.
curl -fsSL https://seahelm.dev/install.sh | shOr download from GitHub Releases.
Workspace & panes — Manage multiple repos and git worktrees as tabs. Split panes inside a worktree so multiple agents run in parallel.
Agent status — Manifest-driven status detection covers 12 agents: agent, aider, amp, claude, cline, codex, cursor, gemini, goose, kiro, opencode, pi. Claude Code and Codex have native hook integration with suggestion cards.
| Agent | Status detection | Event hooks | Suggestion cards |
|---|---|---|---|
| Claude Code | ✅ | ✅ native hooks | ✅ |
| Codex | ✅ | ✅ native hooks | ✅ |
| opencode | ✅ | ✅ plugin | |
| Others (9) | ✅ screen-scan | — | — |
Side panel — File tree, code editor (CodeEditSourceEditor), Markdown preview, and git diff review without leaving the worktree.
The Island — A status pill at the top of the screen. Stays quiet until a worktree needs you: running, waiting, or broken. Agent suggestions arrive as clickable cards.
First Mate — Watches pane state transitions and generates cards: suggestions, waiting/error alerts, and "return to port" cleanup prompts.
Control socket — Agents can drive Seahelm via a CLI:
seahelm pane list
seahelm pane read <pane> --lines 50
seahelm pane split <pane> --direction right
seahelm pane run <pane> "npm test"
seahelm wait agent-status <pane> --status Idle
seahelm pane explain <pane> # which rule decided this status?
seahelm layout exportEvery pane gets SEAHELM_PANE_ID for self-reference. Full surface: seahelm <ping|session|pane|wait|events|layout>.
Token usage — Claude and Codex token/quota usage summarized in-app.
Sessions — Each pane runs in its own seahelmd daemon (bundled, built from seahelmd/), which owns the terminal and keeps its screen in libghostty-vt. Quit the app and the agent keeps working; reopen it and the pane comes back exactly as it was. After a reboot the agent resumes its conversation.
- Developers working with Claude Code, Codex, or similar coding agents
- People managing multiple branches and worktrees daily
- Teams using AI-assisted coding in regular development
Requires XcodeGen:
xcodegen generateBuild (CodeEditSourceEditor requires skipping plugin validation):
xcodebuild -project seahelm.xcodeproj -scheme seahelm \
-configuration Debug -skipPackagePluginValidation -skipMacroValidation buildBuild and launch (artifacts in .build/):
./run.shRun UI tests:
./run_ui_tests.shPackage a release zip for the current architecture:
./scripts/package_release.sh # → dist/Swift + AppKit, macOS 14.0+, four layers:
- App coordinators (
Sources/App/) — window, tabs, split panes, side panels - UI layer (
Sources/UI/) — dashboard, island, splits, title bar, worktree sidebar - Core services (
Sources/Core/,Sources/Status/) — agent state tracking, status detection pipeline, First Mate rules engine, control socket - Terminal & system (
Sources/Terminal/,Sources/Git/) — Ghostty C API, git worktree discovery
See CLAUDE.md for details and docs/ for design notes.
Pushing a v* tag triggers the release workflow, which builds arm64 and x86_64 macOS artifacts.
With repository secrets configured (APPLE_CERTIFICATE_P12, APPLE_DEVELOPER_IDENTITY, APPLE_ID, APPLE_TEAM_ID, etc.), the workflow also signs, notarizes, and staples the app.
Seahelm is released under the MIT License.
It builds on other people's work — notably the Ghostty terminal engine (MIT) and Keep's libghostty-vt bindings (MIT) for session persistence. Bundled Swift packages are MIT, BSD-3-Clause, or Apache-2.0; each retains its own copyright and license.
Third-party components bundled in the app — Ghostty, Keep, the Rust crates in seahelmd,
Sparkle and the Swift packages — are listed with their full license texts in
THIRD-PARTY-NOTICES.md.



