Coding got faster. Managing agents didn't.
octomux is a local dashboard for running many Claude Code and Cursor agents in parallel. Each agent works in its own git worktree; you get one inbox for every "allow this tool?" prompt, a live grid of the whole fleet, and in-app diff review with a Ship button. Runs on your machine — no cloud, no telemetry, MIT.
npm install -g octomux && octomux init && cd your-repo && octomux startOpen localhost:7777, describe a task, pick Claude Code or Cursor, and watch it work.
Three phases, one window — from prompt to merged PR:
- ① Dispatch — Type a task (or paste a Jira/Linear/GitHub link, or a whole list). Each one gets its own worktree, branch, and agent. Pick the model per task.
- ② Watch — Every agent's live terminal, the diff as it grows, and a Monitor grid of the whole fleet. Permission prompts land in one inbox instead of scattered across panes.
- ③ Review & Ship — Diff review in the same window: mark files reviewed, leave inline comments, send them back to the agent to fix, then Ship to open the PR — which auto-closes the task when it merges.
Crash, reboot, close the lid — octomux start restores every task, branch, and session.
| Home inbox + composer — permission prompts, recent activity, dispatch bar |  |
| Command center — kanban from backlog → done |  |
| Task cockpit — agent tabs, live session, Ship, Done |  |
| Diff review — file tree, reviewed state, inline comments |  |
Each screen is a lens over one managed agent backend:
- Sessions inbox — every permission prompt across every agent in one place; reply once, agents keep going. Tab title shows
(N) octomuxwhen something needs you. - Command center — kanban across the real workflow (backlog → planned → in progress → review → PR → done), with filter-to-attention and a restore grace period on delete.
- Monitor grid — every running agent's terminal tiled into one live wall; spot the stuck one instantly.
- Orchestrator view — watch an agent that dispatches agents: the parent planning, its children coding, who's blocked — the whole tree at once.
- Review workstation — an agent drafts a walkthrough + inline comments (grounded against the real diff, no invented line numbers); nothing hits GitHub until you accept it, then it posts as one batched review. Reject a comment with a reason and it remembers for next time.
- Chats, Workspaces, Skill & Agent editors — detach a quick spike as its own session, manage the reusable worktrees behind your tasks, and author your Claude Code skills and subagents in the browser.
- Agent teams — reusable crews as code in
<repo>/.octomux/team.yaml; a lead spawns workers (each with its own model) on demand or on a schedule. - Worktrees keep agents off each other — five agents can edit
auth.tsat once without conflicts on your main tree. - Run it anywhere — npm CLI, a macOS desktop app (
.dmg), or hosted on a box and reached from your phone over Tailscale (the UI is mobile-ready). - Local-only — no telemetry, no cloud sync. Your
.envstays on the host.
Three workflows octomux makes one-click:
- Verifier — two agents, two opinions. Claude wrote it; drop Cursor on the same branch for a second pass. A different model reads the diff without inheriting the first's assumptions, catching the bugs that pass type-checking but break in prod.
- Sweep — five PRs by lunch. Paste a Jira filter or GitHub issue list; each ticket gets its own worktree and agent. Come back from standup to a kanban of ready-to-review PRs.
- Operator — one prompt becomes an epic. Give an agent the orchestrator skills; it plans a spec, breaks it into subtasks, and dispatches each into its own worktree. You supervise from the Orchestrator view.
| octomux | vibe-kanban | Conductor | Emdash | |
|---|---|---|---|---|
| License | MIT, open source | MIT (community*) | Closed | Open source |
| Fully local, no cloud | Yes | Now local* | Cloud account | Yes |
| One permission inbox | Yes | No | No | No |
| Monitor grid (all agents at once) | Yes | No | No | No |
| Automated review + human-gated publish | Yes | Partial | Partial | No |
| Recursive orchestration | Yes | No | No | No |
| Reach it from your phone | Yes (tailnet) | No | No | Partial (SSH) |
| Claude Code + Cursor | Yes | Yes (10+) | Yes | Yes (20+) |
| Platform | macOS + Linux | macOS/Linux/Win | macOS only | macOS/Linux/Win |
* Bloop, the company behind vibe-kanban, wound down in early 2026; it continues as a community project.
The editor was built around a human typing one file at a time. That's not the job anymore. The job is directing a fleet — and the hard part moved from writing code to reviewing it, unblocking it, and knowing what's happening across ten sessions.
octomux is a bet on what that surface should look like: not a chat box bolted onto a file tree, but a control deck. It handles the ugly backend of running agents and puts the human's job — the inbox, the fleet grid, the review workstation, the orchestrator — front and center. It's early and opinionated, and the roadmap is shaped in the open.
- macOS (arm64/x64) or Linux for the CLI; macOS for the desktop app
- Node.js 20+ ·
git(tmuxships bundled) - At least one harness: Claude Code (
claude) and/or Cursor CLI (cursor-agent)
Full CLI reference
| Command | Description |
|---|---|
octomux start |
Dashboard at :7777 (add --bind 0.0.0.0 for remote) |
octomux init |
Defaults wizard (Jira/Linear, base branch, harness prefs) |
octomux create-task |
New task (--harness, --model, --mode, --fork-from) |
octomux list-tasks / get-task |
Inspect tasks |
octomux close-task / delete-task |
Stop or fully remove |
octomux resume-task |
Resume a closed task |
octomux add-agent |
Another agent window (--model, --notify-agent) |
octomux send-message |
Message a running agent — course-correct without restart |
octomux team run / schedule / list |
Run or schedule an agent crew from .octomux/team.yaml |
Full setup, Jira/Linear, and orchestrator skills: ONBOARDING.md.
Remote access from your phone (Tailscale)
octomux binds to 127.0.0.1 by default. To reach it from another device, put them on a
Tailscale tailnet and start in remote mode:
octomux start --bind 0.0.0.0 # or: OCTOMUX_BIND=0.0.0.0 octomux startA random access token is generated on first start (path logged to
~/.octomux/data/remote-token; override with OCTOMUX_REMOTE_TOKEN). Open
http://<host-magicdns-name>:7777 from a tailnet device and sign in once. Only tailnet
devices can reach the port; the token is a second factor. For HTTPS, front it with
tailscale serve.
Built to extend
octomux keeps a clean line between the agent backend (done for you) and the views (where the value is). Building blocks available today:
- REST API (~95 endpoints) over tasks, agents, diffs, reviews, chats, workspaces, skills.
- Two live WebSocket channels —
/ws/eventsfor task/chat/review events,/ws/terminal/*for bidirectional xterm ↔ tmux. - A queryable SQLite schema — tasks, agents, permission prompts, review runs, comments, learnings.
- A pluggable harness interface — add a new agent backend by implementing one interface and registering it.
- User hook scripts — drop executables in
~/.octomux/hooksto fire on task-lifecycle events.
There isn't a drop-in plugin API for custom UI views yet — adding one means building against these blocks in the codebase. A first-class way to author and share views is the direction we're building toward; if that's what you want, open an issue.
How is this different from tmux + Claude Code? octomux adds the inbox, the fleet grid, the review workstation, and the orchestrator view on top. tmux is plumbing underneath.
What if two agents touch the same file? They can't — each task runs in its own git worktree on its own branch.
Can I use it from my phone? Yes — host it on a tailnet box and open the mobile-ready dashboard from any device on the tailnet.
What if my laptop reboots? Run octomux start; tasks, branches, terminals, and review state come back.
Issues and PRs are welcome — the roadmap is shaped in the open.
git clone https://github.com/ShreyPaharia/octomux && cd octomux
bun install
bun run dev # Express :7777 + Vite
bun run test # vitestThen open a PR against next with a short description of the change. See
CONTRIBUTING.md for architecture and testing patterns, and
good first issues
to get started. We try to respond to PRs within a couple of days.
If octomux saves you an afternoon of babysitting agents, a ⭐ helps other people find it — and tells me which parts to build next. Thanks for trying it.
GitHub · npm · octomux.com · Releases