jandresgarcia.dev
Rev. 2026.09
ENES

How Agentville works: a free, open-source Claude Code desktop mod that draws every session as a pixel-art office, lines up permission requests at your desk and sends signed orders back through files on your machine, with no network calls.

AN-04

Agentville A pixel-art office where every Claude Code session works, and you approve, answer and message them all from one desk.

Open source · macOS · agentville.jandresgarcia.dev ↗

Video 1. Agentville, product overview · 1:03

0

Network calls. Sessions, orders and approvals travel as files on your own machine.

How it works

Engineering notes

  • Every session is an office: the Lead and its subagents at their desks, idle agents in the lounge, and agents that need your OK waiting in line at your desk, where A and R approve or reject.
  • One panel for every session: a usage screen with spend, context and tool calls, each agent's plan, steps and conversation, and a message field that reaches any session or subagent.
  • An optional team flow: the Lead triages each change small, medium or large by risk, and nine plugin agents (Secretary, Product, spec-writer, builders, four reviewers and an approver) take it from spec to merge.

Open sourceClaude CodeMulti-agentDeveloper toolsLocal only

TypeScript · Claude Code plugin (hooks, agents, skills) · Claude desktop app · HMAC-SHA256 · MIT

How a run works

  1. You run several Claude Code sessions; each Lead and its subagents becomes an office.
  2. With the team flow on, the Lead triages every change small, medium or large and hands it to the plugin's agents.
  3. The mod's hooks write each session's heartbeat, masking obvious tokens first.
  4. It lands in the sessions folder, on this machine only.
  5. The panel reads every status file every 3 seconds and draws each session as an office.
  6. An agent that needs your OK walks to your desk and waits in line; its session holds the request for about 8 seconds.
  7. Press A or R: the panel writes a signed order for that session and the exact command the card showed.
  8. The session reads its orders every 1.5 seconds, checks the signature and acts once. Past the hold, it asks in its own prompt.

System components

ComponentWhat it does
Claude Code sessionsLead + subagentsAI model callEach session is an office with its team: the Lead, the session's main agent, and its subagents.
Team flowOptional · 9 agentsAI model callThe Lead triages each change small, medium or large by risk. The Secretary and Product check new or high-impact work against your goals file, the spec-writer writes the spec, builders build, up to four reviewers (security, UX, UI design, code) review, and the approver closes a large change.
Mod hooksHeartbeat · order checkDeterministic codeThe mod's hooks in every session write its status and read its orders. Obvious tokens are masked before anything is written.
Status filessessions/<id>.jsonDataOne heartbeat file per session in ~/.claude/agentville, a folder only you can open (chmod 700): agents and states, permission requests, spend and recent messages. Nothing leaves the machine.
Signed orderscontrol/<id>.json · every 1.5 sDataThe panel writes orders here and each session reads its own file every 1.5 seconds. Every order is signed with HMAC-SHA256 for its target session, counts for two minutes and acts once.
Panel/agentville · every 3 sDeterministic codeOpened with /agentville in the Claude desktop app, it reads every status file every 3 seconds. English or Spanish, with a guided tour by Gem, the Secretary.
Pixel officeDesks · lounge · usageDeterministic codeEvery session gets an office with its desks, plan board and usage screen (spend, context, tool calls). Idle agents rest in the lounge; click an agent to see its plan, steps and conversation.
Your deskApprove A · Reject RDeterministic codePermission requests wait in line here. A session holds a request for about 8 seconds, then falls back to its own prompt. Approve allows exactly what the card shows.

Availability

Open to senior AI Engineer and Fullstack roles, and to AI product builds for founders.

Download CV (PDF)EmailLinkedInGitHub