savannahfeder / agentbox

Agentbox 
 Give your agents an inbox. 
 Run dozens of Claude Code and Codex agents in parallel, each in its own git worktree, 
 and only hear from the ones that need you.
 Get it ·
 How it works ·
 Priorities ·
 Keys ·
 Privacy ·
 GPL-3.0 
 Free and open source. A Mac app, or in your browser on any platform with npx agentbox-app , 
 on the Claude Code or Codex plan you already have. No server, no account, no extra subscription.
---
## Install
There are two ways to run it: in the browser, or as a Mac app. Both need Node 22 and Claude Code or Codex installed and signed in.
**In your browser.** One command, nothing to install first:
 [code] 
It starts on your machine and opens a tab. On Linux that open goes through `xdg-open`. Nothing is hosted: it listens only on `127.0.0.1`, and the address carries a key that is new every run. Add `--help` to see the options. `--no-open` prints the address and leaves the browser to you.
From a checkout, build the screen once, then start it the same way:
 [code] 
**As a desktop app.** Build it from this repo. `npm start` is the desktop command on Omarchy and on a Mac:
 [code] 
On Linux, `npm install` puts `agentbox` on `~/.local/bin` and adds the app to the launcher. The entry is `$XDG_DATA_HOME/applications/agentbox.desktop` (`~/.local/share/applications` when that variable is unset), and it runs `agentbox`. That command starts this checkout. Open the app from the launcher.
`npm start` builds the app and opens it. On first run it walks you through connecting Claude Code or Codex and choosing a folder to work in.
On macOS, the system may ask to let Terminal find devices on your local network. Agentbox does not need that, so Don't Allow is fine.
## The chat window is the bottleneck
Today you run agents in chat windows and terminals, and you wait for each one
to finish before you prompt it again. So the number of agents you can run is limited 
by the number of windows you can keep track of.
Models are now good enough that most tasks do not need watching. They need
someone to review the work at the right moment. Agentbox drops the chat window
and gives each agent a row in an inbox instead, so you can run far more of them
than you could ever watch and only deal with one when it actually needs you.
## How it works
### 1. File the work
Paste a list, send over a board of issues, or type one task. Each item becomes
its own row, and each row is its own agent, already working in its own git
worktree and on its own branch, so no two agents touch the same files.
### 2. Walk away
Nothing needs you while they run. Go to lunch. A row only comes back to you
when its agent is done or stuck, so a hundred agents working is as quiet as one.
### 3. Come back to an inbox
Every row opens with what the agent did and what it wants from you, in two
lines you can read at a glance. Most of the time the answer is yes. Press `1`
and it merges, and the next one is already in front of you.
### 4. Answer however fits
 Pick a design. Ask for option