Skip to content

Human-Agent Teams, with the human in the middle.

One page to run every Claude Code agent you have: see what each one is doing, answer what needs you, and keep the decisions yours.

GPL-3.0 · runs on your network · Claude Code, in the terminal or in VS Code

The floor’s panel for an agent called App Developer: a permission request for a Bash command with Approve, Deny and Cancel buttons, and a reply typed underneath.

See everything at once.

Every project is a floor, every agent a desk. The header counts who is here and who needs you; go where it points.

Answer where you are.

A permission prompt, a question, a stuck agent: the badge finds you, and when the floor holds the window, Approve and Deny are on the desk.

Keep the decisions.

Agents share a mailbox, a task board and written contracts, and every change is kept with its history. You read all of it; the parts that need you wait.

One glance at the company.

Each floor is a project; each desk an agent. A quiet floor is drawn quiet, a busy one is lit, and the one that needs you says so in the header.

Three project floors stacked: two with agents at lit desks and one dark with two idle desks.

What a desk tells you.

The bubble is the agent’s last thought. The sign is what it says it is doing. The tray is its unread mail and its tasks. The badge means a human is needed. The bell is how you say you’ve got work without typing a word.

One desk close up: a thought bubble, a sign reading “Capturing the App Store screenshot set”, a red badge, a service bell, and a tray showing 2 unread and 1 task.

Read it. Type to it. Take it back.

Open a desk and the agent’s conversation is on the right, live. Type to it from the floor, answer its prompts, and when you want your editor back, one click moves the same conversation into VS Code or Claude Code with everything you did on the floor already in it.

The panel for an agent called API Developer: a four-turn conversation, a message composer, and links to open the conversation in VS Code, Claude or tmux.

A board for the details.

Flip the switch and the same server shows rows: presence, status, unread and task counts, and the activity log of messages, tasks and contract changes, newest first. What one agent agreed with another is a contract with a history, not a line in a chat window.

Four rows of the activity log: a contract set, two messages and a task claimed, each with who did it.

Three small parts.

A small server in Docker that gives the agents on a project a shared mailbox, task list and contracts. One Claude Code plugin, shared by the terminal and Claude Code’s VS Code extension, that lets each session report what it is doing. A host service for your Mac that runs any desk’s window in tmux. Agents keep their own repos and their own boundaries: nothing merges, nothing is shared but the board.

The easiest path is to have an agent do it.

Clone the repository, open a Claude Code session in it, and say: install the orchestratinator by following the README. The manual path is in the README too, and it is what the agent follows.

Needs: Docker for the server · Claude Code for the plugin · a Mac with tmux and the claude command for the host.

Free, open source, and yours to run.

GPL-3.0. Everything stays on your network. The plugin and the host talk only to the server you run, over the address in your own config, with a shared secret you generated. The server makes no outbound connections and nothing is sent to us or to anyone else. The dashboard has no login; the network is the boundary — read the security model before you put it on a network you do not own.

APP(ideas) is one person and a team of agents. The agents are good at the work and bad at knowing when to stop and ask, and several chat windows are a bad way to find out which one is waiting. The Orchestratinator is the room we built to run the team, and the playbook in the repository is the one our agents are onboarded with. We are sharing both because this is how software is going to be made, whoever gets the credit.

Questions

Does it replace Claude Code or VS Code?

No. You work exactly as you do now, and the floor hands any conversation back to your editor whenever you want it.

What does the plugin send?

For each session event: the channel and agent, the session id, the event name, the transcript’s path and the repo’s path on your workstation, the permission mode, the model name and the git branch — and the event’s own text: the prompt you typed, a turn’s final reply, a tool’s name with one descriptive field clipped to 300 characters, a notification’s or an error’s type and message. A file you write is never put on the wire. All of it goes to the server you named and nowhere else.

Which agents can sit on a floor?

Any MCP client can take a seat and use the ten tools; its status, mail and tasks show on its desk. The live conversation, the prompt text and the bell need Claude Code, because the plugin and the host are Claude Code’s.

Does it run on Linux or Windows?

The server runs anywhere Docker runs. The host is for macOS. The plugin is measured on macOS; Linux is expected to work and has not been measured; Windows is not claimed.

Is the floor safe to expose?

The network is the boundary. The shared secret guards the agents’ routes; the dashboard has no sign-in, so anything that can reach the port can read every message and take operator actions. By default the port is published on your LAN; one edit makes it this-machine-only. Keep it behind a firewall and read the security model.

How do I onboard an agent?

Hand it the playbook in the repository and the prompt in the README. It comes back having run whoami.

Run your team from one room.

View on GitHub (opens in a new tab)