jandresgarcia.dev
Rev. 2026.09
ENES

Cómo funciona Agentville: un mod gratuito y de código abierto para Claude Code en el escritorio que dibuja cada sesión como una oficina pixel art, pone en fila las solicitudes de permiso en tu escritorio y devuelve órdenes firmadas por archivos en tu máquina, sin llamadas de red.

AN-04

Agentville Una oficina pixel art donde trabaja cada sesión de Claude Code, y desde un solo escritorio las apruebas, respondes y les escribes a todas.

Código abierto · macOS · agentville.jandresgarcia.dev ↗

Video 1. Agentville, resumen del producto · 1:03

0

Llamadas de red. Sesiones, órdenes y aprobaciones viajan como archivos en tu propia máquina.

Cómo funciona

Notas de ingeniería

  • Cada sesión es una oficina: el Lead y sus subagentes en sus escritorios, los agentes libres en el lounge y los que necesitan tu OK haciendo fila en tu escritorio, donde A y R aprueban o rechazan.
  • Un panel para todas las sesiones: una pantalla de uso con gasto, contexto y llamadas a herramientas, el plan, los pasos y la conversación de cada agente, y un campo de mensaje que llega a cualquier sesión o subagente.
  • Un flujo de equipo opcional: el Lead clasifica cada cambio como pequeño, mediano o grande según su riesgo, y nueve agentes del plugin (Secretaria, Producto, spec-writer, builders, cuatro revisores y un aprobador) lo llevan de la spec al merge.

Código abiertoClaude CodeMultiagenteHerramientas de desarrolloSolo local

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

Cómo funciona una corrida

  1. Tienes varias sesiones de Claude Code abiertas; cada Lead con sus subagentes se vuelve una oficina.
  2. Con el flujo de equipo activo, el Lead clasifica cada cambio como pequeño, mediano o grande y se lo pasa a los agentes del plugin.
  3. Los hooks del mod escriben el latido de cada sesión, enmascarando antes los tokens evidentes.
  4. Queda en la carpeta de sesiones, solo en esta máquina.
  5. El panel lee todos los archivos de estado cada 3 segundos y dibuja cada sesión como una oficina.
  6. Un agente que necesita tu OK camina a tu escritorio y hace fila; su sesión retiene la solicitud unos 8 segundos.
  7. Presionas A o R: el panel escribe una orden firmada para esa sesión y el comando exacto que mostró la tarjeta.
  8. La sesión lee sus órdenes cada 1,5 segundos, verifica la firma y actúa una sola vez. Pasado el tiempo de espera, pregunta en su propio prompt.

Componentes del sistema

ComponenteQué hace
Sesiones de Claude CodeLead + subagentesLlamada a modeloCada sesión es una oficina con su equipo: el Lead, el agente principal de la sesión, y sus subagentes.
Flujo de equipoOpcional · 9 agentesLlamada a modeloEl Lead clasifica cada cambio como pequeño, mediano o grande según su riesgo. La Secretaria y Producto revisan el trabajo nuevo o de alto impacto contra tu archivo de metas, el spec-writer escribe la spec, los builders construyen, hasta cuatro revisores (seguridad, UX, diseño UI, código) revisan y el aprobador cierra un cambio grande.
Hooks del modLatido · chequeo de órdenesCódigo deterministaLos hooks del mod en cada sesión escriben su estado y leen sus órdenes. Los tokens evidentes se enmascaran antes de escribir nada.
Archivos de estadosessions/<id>.jsonDatosUn archivo de latido por sesión en ~/.claude/agentville, una carpeta que solo tú puedes abrir (chmod 700): agentes y estados, solicitudes de permiso, gasto y mensajes recientes. Nada sale de la máquina.
Órdenes firmadascontrol/<id>.json · cada 1,5 sDatosEl panel escribe aquí las órdenes y cada sesión lee su propio archivo cada 1,5 segundos. Cada orden va firmada con HMAC-SHA256 para su sesión destino, vale dos minutos y actúa una sola vez.
Panel/agentville · cada 3 sCódigo deterministaSe abre con /agentville en la app de escritorio de Claude y lee todos los archivos de estado cada 3 segundos. En español o inglés, con un tour guiado por Gem, la Secretaria.
Oficina pixel artEscritorios · lounge · usoCódigo deterministaCada sesión tiene una oficina con sus escritorios, su tablero de plan y su pantalla de uso (gasto, contexto, llamadas a herramientas). Los agentes libres descansan en el lounge; un clic en un agente muestra su plan, sus pasos y su conversación.
Tu escritorioAprobar A · Rechazar RCódigo deterministaLas solicitudes de permiso hacen fila aquí. Una sesión retiene la solicitud unos 8 segundos y luego vuelve a su propio prompt. Aprobar permite exactamente lo que muestra la tarjeta.

Disponibilidad

Abierto a roles senior de AI Engineer y Fullstack, y a construir productos de IA para founders.

Descargar CV (PDF)EmailLinkedInGitHub