bora, open source
Several coding agents running. bora shows which one needs you.
bora in one minute
0:00 Which one needs you?
1 min English captions Assistir em português
Chapters
-
herdr, plus what it takes to run a fleet of agents.
-
Worktree, workspace, folder, agent and prompt, in one go.
-
Copy reference on a pane: the receiver sees who sent it, and if it is busy the prompt waits in line.
-
Working, blocked or done in the sidebar. A message for you becomes a badge and never switches your screen.
-
Workspaces sit only in the folders you created.
-
Undoes your typing instead of suspending the agent.
-
A file viewer, PR status, automations, and your own.
-
Pair your phone and answer your agents from anywhere.
-
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.
-
Project viewWith projects.yml and the project.* verbs.
-
Right panelThe Changes, Checks, Issues and PRs tabs, and the GitHub polling behind them.
-
PR, issue and kanban board in coreIt still exists, as an external plugin.
-
Per-repo command menu (.bora.toml)It became the aryrabelo/bora-local-commands plugin.
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
- macOS Apple Silicon sha256 1a59d0cdd4a2
- macOS Intel sha256 3042936d9763
- Linux x86_64 sha256 733d8d1b76d3
- Linux arm64 sha256 be09ddd05553
- Windows x86_64 (.zip) sha256 1fade63da023
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.
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.