A cartoon 3D office where a team of AI coding agents works through your GitHub issues. You walk the floors, look over their shoulders and watch their pull requests get tested and merged.

npx cubefarm

That's it. cubefarm checks your machine, starts the office and opens it in your browser. The first time, npx asks whether to install cubefarm: say yes.

• Node.js 22 or newer: nodejs.org
• git
• The GitHub CLI, signed in: install it from cli.github.com, then run gh auth login
• A coding agent subscription: cubefarm brings Claude Code, the default agent and the one your CEO runs: sign in once with npx cubefarm login. You don't need to install it. Agents can also run Codex or OpenCode, if you have them installed and signed in.
• Google Chrome, for agents that test your app in a browser.

It runs on Windows, macOS and Linux. Not sure you're ready? npx cubefarm doctor checks all of it.

npx cubefarm --demo

Demo mode fakes GitHub and the agents, so it costs nothing and changes nothing.

1. Set up your company. A short wizard asks your name, names your company and introduces your CEO.
2. Move in a project. Pick one of your project folders or a GitHub repo, or start a new one. It gets its own floor. Every project needs to be on GitHub, because issues and pull requests are how the team works.
3. Let the CEO plan. The CEO studies the project, writes its QA checklist, plans the work as GitHub issues and proposes who to hire. Press P for your phone to chat with them and approve hires.
4. Watch the work. Developers pick up issues and open pull requests. QA testers review and test each one in a real browser, then post a report with screenshots. With auto-merge on, a pull request merges itself once QA passes and GitHub's checks are green.

• Floors: one per project. Ride the elevator between them.
• Desks: walk up behind an agent to watch their monitor. Open it to see their real terminal: every agent is an actual coding agent running on your machine, and you can type into it. It also shows a live browser when they test the UI. Pick the coding agent, model and effort for the whole team or per agent.
• The QA lab: every floor has at least one QA tester.
• The whiteboard: the Kanban board, from backlog to merged.
• The lobby: the manager's office, where you connect projects, hire, file issues and change settings, and the CEO's corner office.

npx keeps using the version it downloaded first. When a newer one is out, cubefarm tells you as it starts. To update:

npx cubefarm@latest

Prefer a permanent install? Run npm install -g cubefarm, then start it with cubefarm.

Running it from a clone of this repo (npm start)? Then the office updates itself from GitHub once its agents are done: see Updating the office.

• It runs on your coding agents' subscriptions. Agents on the same coding agent draw on the same usage limits. To cap how many work at once, set a session limit in the manager's console.
• Agents work on your machine, like your own coding agents: with your skills, MCP servers and settings, each in its own copy of the repo. They can't push to your main branch or merge: the office merges, after QA.
• Your office lives in ~/.cubefarm: settings, clones of your repos and one working copy per agent. Set SWARM_HOME to use another folder.

• How it works: the life of an issue, QA, auto-merge, models and usage, the safety model and floor previews
• Contributing: run it from source, tests, architecture and publishing

MIT