How blendi-remade/agentcraft works
AgentCraft pairs a Minecraft studio client with the Foreman service. A user submits a goal through the in-game console; Foreman coordinates planning and agent work in isolated Git worktrees, streams state back to the client, and the user answers questions and reviews proposed diffs before approving a merge. The graph retains the documented safety, memory, simulation, and studio-world capabilities. Several subsystem links are documented in the README; unsampled implementation details are not inferred.
Main entry points: ForemanState.java Client state · foreman.ts Foreman core · Foreman.java Foreman link · server.ts WebSocket server
Components 23
Minecraft client
- Goal console
mod/src/client/java/dev/agentcraft/client/console/ConsoleActions.java - Foreman link
mod/src/client/java/dev/agentcraft/client/foreman/Foreman.java - Client state
mod/src/client/java/dev/agentcraft/client/foreman/ForemanState.java - Task wall
mod/src/client/java/dev/agentcraft/client/taskwall/TaskScreen.java - Agent monitors
mod/src/client/java/dev/agentcraft/client/monitor/MonitorScreen.java - Decision podium
mod/src/client/java/dev/agentcraft/client/decisions/DecisionScreen.java - Diff review
mod/src/client/java/dev/agentcraft/client/diff/ReviewKit.java - Shared library
mod/src/client/java/dev/agentcraft/client/library/MemoryIndex.java
Foreman service
- Wire protocol
foreman/src/protocol.ts - WebSocket server
foreman/src/server.ts - Foreman core
foreman/src/foreman.ts - Runtime config
foreman/src/config.ts
Agent work
- Claude agents
foreman/src/agents/claude/stream.ts - Simulation backend
foreman/src/agents/sim/director.ts - Sim scenarios
foreman/src/agents/sim/scenario.ts - Git worktrees
foreman/src/repos.ts
Studio world
- Agent movement
mod/src/client/java/dev/agentcraft/client/agents/AgentLife.java - Agent manager
mod/src/client/java/dev/agentcraft/client/agents/AgentManager.java - HQ features
mod/src/main/java/dev/agentcraft/hq/HqFeature.java - Studio anchors
mod/src/main/java/dev/agentcraft/layout/Anchors.java - Mod initialization
mod/src/main/java/dev/agentcraft/AgentCraft.java
Other components
- User
- User repository
Connections 27
- User → Goal console: enters goal
README.md - Goal console → Foreman link: submits goal
mod/src/client/java/dev/agentcraft/client/foreman/Foreman.java - Foreman link → WebSocket server: sends messages
- WebSocket server → Wire protocol: parses messages
foreman/src/server.ts - WebSocket server → Foreman core: routes intents
foreman/src/server.ts - Foreman core → Wire protocol: emits state
foreman/src/foreman.ts - Wire protocol → Client state: defines updates
foreman/src/protocol.ts - Foreman link → Client state: applies updates
mod/src/client/java/dev/agentcraft/client/foreman/Foreman.java - Foreman core → Runtime config: uses settings
foreman/src/foreman.ts - Foreman core → Claude agents: drives agents
- Foreman core → Simulation backend: selects backend
- Simulation backend → Sim scenarios: runs scenarios
foreman/src/agents/sim/index.ts - Foreman core → Git worktrees: manages worktrees
README.md - Git worktrees → User repository: isolates changes
README.md - Client state → Task wall: shows tasks
mod/src/client/java/dev/agentcraft/client/taskwall/TaskScreen.java - Client state → Agent monitors: shows live logs
README.md - Client state → Decision podium: shows questions
README.md - Decision podium → Foreman link: sends answers
mod/src/client/java/dev/agentcraft/client/foreman/Foreman.java - Client state → Diff review: shows diffs
README.md - Diff review → Foreman link: requests diff
mod/src/client/java/dev/agentcraft/client/foreman/Foreman.java - Client state → Shared library: shows memory
README.md - Client state → Agent manager: updates agents
mod/src/client/java/dev/agentcraft/client/agents/AgentManager.java - Agent manager → Agent movement: updates motion
mod/src/client/java/dev/agentcraft/client/agents/AgentManager.java - Mod initialization → HQ features: initializes HQ
mod/src/main/java/dev/agentcraft/AgentCraft.java - Mod initialization → Studio anchors: initializes anchors
mod/src/main/java/dev/agentcraft/AgentCraft.java - Agent manager → Studio anchors: uses layout
mod/src/client/java/dev/agentcraft/client/agents/AgentManager.java - HQ features → Studio anchors: reads layout
mod/src/client/java/dev/agentcraft/client/hq/HqClientFeature.java