See, launch and coordinate every coding agent on your machine, from your terminal.
[!NOTE]
volee is young and built in the open. Expect rough edges and tell us about
them; the roadmap
says what comes next.
Why
You run five Claude Code sessions in five worktrees. One waits for a
permission, one finished an hour ago, two are talking to each other through a
coordinator, and you are not sure which branch was pushed. volee answers, in
one screen:
- Who is running? Every agent on the machine, with its state, repository,
branch and worktree, whether you started it or another agent did.
- Who needs me? Permission prompts, questions and finished work, sorted by
urgency.
- What did they do? Commits, diffs, push state, pull request and checks.
- Who talks to whom? Messages between agents and with you, as threads and
as a live graph where each message travels along its edge.
It also runs missions: a goal across one or more repositories, split by a
coordinator agent and delivered by worker agents, with delivery checked by
code, not by trust.
How it works
- Each agent volee launches runs in a volee host, a small process that holds
its terminal and its exact screen, so it survives closed windows, the
interface and the daemon. Open one with
enter or volee attach, come
back with Ctrl+Q.
- A preview, a full-screen view and a wall of screens show every agent
that runs. An agent volee hosts shows live, exactly as its terminal
does, status line included, without being resized; any other shows as
its harness or its multiplexer replays it.
- volee launches Claude Code and OpenCode agents. A session you started
yourself opens the same way, where it runs:
enter or a double click
puts a terminal on it inside volee (claude attach on a background
session, the pane of a tuios session), with nothing stopped or restarted.
- Any other program runs under volee from your terminal:
volee run -- codex starts it in a volee host, with your terminal on it, and it is
listed, shown and opened like the others.
- The list is what runs now, one row per session, as Claude Code's own
agents view lists them: a session that is gone leaves it.
- After a reboot, the daemon resumes the agents the reboot interrupted, with
their conversation.
volee daemon install starts it at login, if you want.
- Sessions you started by hand in a tuios or tmux pane are found in that
pane: their preview is the pane's screen,
enter opens a tuios pane
inside volee and brings a tmux pane forward.
- Each new worktree can run your setup commands, such as
bun install,
before its agent starts.
- A small local daemon keeps the registry, the event log and the messages in
SQLite. The interface, the command line and the agents all talk to it.
- Agents message each other through an MCP server, which any MCP-capable
harness can use.
- No multiplexer, editor or git client is required: the ones you use (Neovim,
lazygit, VS Code...) open an agent's worktree with a key.
Read the architecture overview
and the design decisions.
Install
The latest release is v0.17.1. Each release
has prebuilt binaries for macOS (Apple Silicon and Intel) and Linux (x86_64
and ARM64), and an installer that checks the download and puts volee in
~/.local/bin:
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/volee-org/volee/releases/latest/download/volee-cli-installer.sh | sh
Or build it from source with Cargo (Rust 1.90 or later and Zig 0.15.2):
cargo install --locked --git https://github.com/volee-org/volee --tag v0.17.1 volee-cli
volee supports macOS and Linux and needs Claude Code
2.1.319 or later for its agent features. The
installation guide
covers specific versions, manual downloads and uninstalling.
Open the interface on every agent of your machine, or try it on a simulated
team of agents first, no setup needed:
volee # the agents on this machine; starts the daemon when needed
volee demo # a simulated team
Then launch your first agent with the
getting started guide:
it takes about ten minutes.
Contributing
Contributions are welcome, including ones written with coding agents. Start
with CONTRIBUTING.md; agents read AGENTS.md.
By participating you agree to the Code of Conduct.
License
Licensed under either of Apache License, Version 2.0 or
MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall
be dual licensed as above, without any additional terms or conditions.
