Skip to content

bora, open source

Several coding agents running. bora shows which one needs you.

A Rust terminal multiplexer, forked from herdr. Every agent in its own pane, one-command dispatch, agents prompting each other and folders to keep the fleet in order. Free and open source.

bora in one minute

0:00 Which one needs you?

1 min English captions Assistir em português

Chapters

  1. herdr, plus what it takes to run a fleet of agents.

  2. Worktree, workspace, folder, agent and prompt, in one go.

  3. Copy reference on a pane: the receiver sees who sent it, and if it is busy the prompt waits in line.

  4. Working, blocked or done in the sidebar. A message for you becomes a badge and never switches your screen.

  5. Workspaces sit only in the folders you created.

  6. Undoes your typing instead of suspending the agent.

  7. A file viewer, PR status, automations, and your own.

  8. Pair your phone and answer your agents from anywhere.

  9. Tracks upstream closely, drops what did not earn its place, installs in one line.

The idea

bora is a background server: the terminals live inside it. Close the lid, drop the network, restart the machine, and the agents keep working and the sessions come back. You reattach from any terminal, including over ssh.

Your agents drive it from the CLI

What you do with the mouse, an agent does through the CLI or the socket API: open a worktree with another agent inside, send a prompt, wait for the other one to stop.

For your agents

bora worktree create --branch <name> --agent <kind> --prompt <text>
Worktree, workspace, folder, agent and prompt in one step. With --prompt-file the agent gets a spec file to read and follow.
bora agent prompt <target> <text> --when-idle
Arrives with the [from <pane> <name>] prefix, so the receiver knows who sent it. With --when-idle it waits in the server's queue while the target is working.
bora agent wait <target> --timeout 600000
Returns when the other agent stops: idle, done or blocked, or whichever state you ask for with --until.
bora mcp serve --allow-prompt
The agent tools over MCP, on stdio, for agents that do not call the CLI. Prompting exists only with --allow-prompt.

For you

bora workspace set-group <workspace_id> clients/api
Files the workspace in a folder of the Folders view; a/b is a folder inside a folder. With no name it leaves the folder. Dragging in the sidebar does the same.
bora plugin install AltanS/collie
Collie, a mobile web client, open source (MIT), by AltanS. Pair your phone and answer your agents from anywhere.
omp plugin install github:aryrabelo/omp-cmd-z-undo
In omp, Ctrl+Z (and Cmd+Z) undoes your typing instead of suspending the agent. bora's installer offers it.

Removed on purpose

These shipped in bora once and were taken out. Why, and what would bring each one back, is in the repository.

The full list, with the reasons

Install

v0.52.11 · free, Apache 2.0 · macOS, Linux, Windows

One-line installer for macOS and Linux. Installs to ~/.local/bin (override with HERDR_INSTALL_DIR); needs curl and awk.

curl -fsSL https://raw.githubusercontent.com/aryrabelo/bora-herdr-ada/main/distribution/install.sh | sh

Windows, in PowerShell:

powershell -c "irm https://raw.githubusercontent.com/aryrabelo/bora-herdr-ada/main/distribution/install.ps1 | iex"

Stable v0.52.11

Preview builds on the releases page

Preview is the latest main, with no stability promise. To switch the update channel of a running install: bora channel set preview && bora update.

All releases Source on GitHub (leave a star)

Get bora updates

Building in public. Drop your email and I'll ping you when a new version ships, alongside the newsletter on AI, automation and engineering. Optional: the install above is free.