Install
Kelpie is a board of every coding agent session on your Mac, sorted by which ones need you. It reads what Claude Code, Codex, Cursor and OpenCode already write to disk, so there is nothing to set up before the first rows appear.
Download
Section titled “Download”Download for Mac from the front page, open the disk image and drag Kelpie into Applications. It runs on Apple Silicon.
Open it and the board is there: every session it found, with the ones waiting on you at the top. The menu-bar icon carries the same count, the Dock badge too, and a notification you can answer arrives when a session starts waiting.
What it uses
Section titled “What it uses”Kelpie is built on tools you probably have already, and each one it finds switches on more:
| Tool | What it adds |
|---|---|
tmux |
Sessions with no window: chat from the board, and the Terminal tab |
gh, signed in |
The pull request chip, its checks and its unresolved threads |
git |
Features and reviews: a branch and a worktree each |
| Caddy | An https domain per feature, instead of a port |
| Tailscale | The board on your phone |
A missing one is never an error on the board: the feature it serves is just absent, and the setup strip above the toolbar names what is missing and the command that fixes it.
The kelpie command
Section titled “The kelpie command”Each time the app launches it puts a kelpie command on your PATH: a script in the first of
~/.local/bin, ~/bin, /opt/homebrew/bin and /usr/local/bin that your login shell lists and
you can write to. It runs the app’s own CLI, so it needs no node and follows the app’s updates,
and it never replaces a kelpie it did not write. See the CLI.
- The board: what each part of it says.
- Parallel agents: a feature from a branch to a pull request.
- Settings: the few things you can change.