leonvanzyl / cubefarm

# ✻ cubefarm
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.
Every agent is a real coding agent, **Claude Code, Codex or OpenCode**, running in a terminal of its own on your machine with your logins, settings, skills and MCP servers. Run the whole team on one, or give each agent its own. The office hands out the work, has every pull request reviewed and tested in a real browser, and merges what passes.
## Get started
 [code] 
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.
### What you need
- **Node.js 22 or newer**: nodejs.org
- **git**
- **The GitHub CLI**, signed in: install it from cli.github.com, then run `gh auth login`
- **Claude Code, signed in**: it comes with cubefarm, so there's nothing to install. Run `npx cubefarm login` once to sign in with your Claude subscription. It's the default coding agent, and the CEO always runs on it.
- **Codex or OpenCode** (optional): if you have them installed and signed in, any agent can run them instead (see Coding agents).
- **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.
### Just want to look around?
 [code] 
Demo mode fakes GitHub and the agents, so it costs nothing and changes nothing.
## Your first five minutes
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 and sizes the floor's team. New work only ever comes from you: give the CEO a brief (when the project moves in, or later with **Plan**) or message them, and they turn it into GitHub issues. The CEO never files issues on its own. Press `P` for your phone to chat with them and approve team changes, or meet the new agents waiting in the lobby and set them up (coding agent, model, effort) before you hire them.
4. **Watch the work.** Agents are interchangeable: a free agent picks up the next issue, builds it on a branch of its own and opens a pull request. Another agent reviews and tests it in a fresh session and a real browser, then posts a report with screenshots on the pull request. If QA fails, the author fixes it and it goes round again. With auto-merge on, a pull request merges itself once QA passes and GitHub's checks are green. Each agent works on a machine of its own (its own clone, worktree and temp folder; see Agents).
## Coding agents
Every agent, the CEO included, is the actual coding-agent CLI in a terminal on your machine. Open someone's de