GitHub - blendi-remade/agentcraft
Short summary
AgentCraft is a tool that runs Claude agents inside a Minecraft environment where you can watch them work on your code in real time. You give them a goal, they plan tasks, write code in isolated git branches, and ask you for decisions when needed — nothing merges without your approval.
- Agents work in their own git worktrees on isolated branches; your main checkout is never touched, and merges only happen when you explicitly approve them
- The interface visualizes agent work through a pixelated Minecraft studio where agents walk to desks, show live code changes on monitors, and come find you with questions
- A real test run on a sample repo landed six features with passing tests, handling merge conflicts, permission prompts, and a Foreman restart — all driven through the game interface
- Small goals cost $2-10 in Claude API usage; you can try it free with a simulated team first
Full summary
AgentCraft is a Minecraft mod that visualizes multi-agent coding work as a playable studio space. You type a goal into a console, and Claude agents (led by a planner named Marlow, with workers Juniper, Kit, Wren, Rowan, and Tove) break it into tasks and start coding in separate git worktrees. Each agent has a desk with a monitor showing live file changes and logs. The interface uses spatial information — colored lamps show who's working or stuck, nameplates indicate what each agent does, and speech bubbles appear when they need your input. Nothing merges to your branch without your explicit approval, and the agents can't push to any remote. The demo shows this working end-to-end on a real repo: six features shipped with passing tests, including handling a merge conflict and recovering from a Foreman restart.
The safety model is built in at multiple levels. Every agent works in its own git worktree under `agentcraft/<agent>/<task>`, leaving your checkout untouched. Risky operations — anything outside the worktree, network calls, destructive commands — trigger in-game permission prompts showing exactly what you'd allow. Git itself blocks pushes, not just a command filter. Commits are authored as the agent's name, so you know who wrote what. The system survives crashes; close the game and the Foreman keeps working, resuming by session ID when you reopen it.
To run it you need Windows 10+ or macOS, Java 25, Node 22+, git, and Minecraft: Java Edition. The agents use Claude via API key (Anthropic, Bedrock, Vertex, or Foundry) or your existing Claude CLI login. Launch with a simple PowerShell script on Windows or a Node script on macOS — the first run downloads Minecraft and Fabric through Gradle (takes a few minutes), then subsequent launches hit the studio in under a minute. You can try the sim backend first with no API cost to see how the interface works, then point it at your own repo.