alejo.santanna/recursos/pixel-agentsGratis
Watch6.7kFork31.2k
GUIA.md3 secciones · 4 prompts

Tu oficina de agentes en pixel art

Cada agente de IA es un personaje que trabaja en su sala, y un orquestador reparte el trabajo entre todos.

01Armala con Claude Code

Copiá el prompt en un bloc de notas, completá lo que está entre corchetes con tus salas y tus agentes, y pegalo en Claude Code. Sigue en la página siguiente.

Repositorio oficial en GitHub
github.com/pixel-agents-hq/pixel-agents
Abrir en GitHub ↗

Este es el link que le pasás a Claude, no el de esta página.

Plantilla · pegar en Claude Code
Quiero armar mi propia oficina virtual de agentes de IA con Pixel Agents: cada agente es un personaje de pixel art que trabaja en su sala, y un agente orquestador reparte el trabajo entre todos.

Repositorio: https://github.com/pixel-agents-hq/pixel-agents

=== MI OFICINA (completá lo que está entre corchetes) ===

Nombre de la oficina: [ej. "Mi Agencia HQ"]
A qué se dedica mi negocio: [ej. agencia de marketing para restaurantes]
Carpeta donde crear todo: [ej. ~/oficina]

Departamentos y agentes (una línea por agente: SALA - Agente: qué hace)
- [Contenido] - [Guionista]: [escribe guiones de reels a partir de una idea]
- [Contenido] - [Editor]: [arma los subtítulos y la lista de cortes de cada video]
- [Clientes] - [Agenda]: [planifica las reuniones y prepara un resumen de cada cliente]
- [Clientes] - [Cotizaciones]: [arma presupuestos con mis precios]
- [Finanzas] - [Facturación]: [lleva el registro de cobros y facturas pendientes]
(agregá o borrá todas las líneas que quieras)

Orquestador: [ej. "Atlas"] - recibe mis pedidos, decide qué agente hace cada parte, les reparte el trabajo y me devuelve el resultado junto.
Herramientas que ya uso (opcional): [ej. Gmail, Google Calendar, Notion]

=== LO QUE TENÉS QUE HACER ===

1. Fijate que tenga Node.js 20 o superior. Si no lo tengo, explicame cómo instalarlo y esperá a que te avise.

2. Instalá Pixel Agents con: npm install --global pixel-agents
   Si falla por permisos, usá npx pixel-agents. Leé el README del repo para entender Directories, Areas y el editor de layout.

3. En la carpeta que te indiqué, creá una subcarpeta por sala y una para el orquestador. En cada sala, un CLAUDE.md con los agentes que trabajan ahí: rol, qué hace, qué entrega y en qué formato.
Pegar en Claude Code
4. En la carpeta del orquestador:
   - un subagente en .claude/agents/ por cada agente de mi lista (con el rol y las tareas que escribí), para que el orquestador les pueda delegar trabajo;
   - un CLAUDE.md que le explique cómo partir mis pedidos, a qué agente mandar cada parte, en qué carpeta guardar cada entrega y cómo juntar todo en una respuesta final.

5. Diseñá la oficina: un layout con una sala por departamento + la sala del orquestador, con un escritorio, una silla y una computadora por agente, y un Area con nombre y color propio en cada sala. Usá como base el formato del layout por defecto del repo: webview-ui/public/assets/default-layout-1.json
   webview-ui/src/office/types.ts
   Guardalo en ~/.pixel-agents/layout.json. Si ya existe, hacé una copia antes de pisarlo.

6. Con Pixel Agents apagado, registrá cada carpeta como Directory y asignale su Area en ~/.pixel-agents/config.json (userDirectories y areaMappings; fijate el formato exacto en server/src/configPersistence.ts del repo). Así cada agente se sienta en su sala.

7. Arrancá la oficina con: pixel-agents --port 3100
   Pasame la URL que imprime (trae un token: no la compartas) y avisame que tengo que aprobar los hooks una sola vez desde el navegador para que los personajes se muevan en tiempo real.

8. Al terminar, dame un resumen corto: qué carpetas creaste, qué hace cada agente y cómo le pido algo al orquestador.

Reglas: no borres ni pises nada que ya exista sin preguntarme. Si alguna parte del layout no carga bien, arreglala o decime exactamente qué pintar a mano en el editor Layout.
Nota
Cómo completar la plantilla

Pensá en tu negocio como una oficina: cada sala es un área (contenido, clientes, finanzas) y cada agente es un empleado con una sola tarea clara. Mejor 4 o 5 agentes bien definidos que 15 genéricos. Los ejemplos entre corchetes son solo guía: borralos y poné los tuyos.

02Usala todos los días

En la oficina, tocá + Agent y elegí la carpeta del orquestador (o la de cualquier sala). Cada agente aparece como un personaje: escribe cuando edita archivos, lee cuando busca y muestra un globo cuando te está esperando.

Pedirle trabajo al orquestador

Le hablás a uno solo y él reparte entre las salas.

Pedido al orquestador
[Atlas], armame el contenido de la semana: 3 guiones de reels sobre [tema] y la lista de cortes de cada uno. Después preparame el resumen del cliente [nombre] para la reunión del [día].

Sumar un agente nuevo

La oficina crece con tu negocio, sin tocar nada a mano.

Pedido a Claude Code
Agregá a mi oficina un agente [Soporte] en la sala [Clientes] que [responda las consultas frecuentes de mis clientes]. Creale su subagente, sumale un escritorio en el layout y actualizá el CLAUDE.md del orquestador para que sepa que existe.

Ver quién está trabajando

Con varios agentes en paralelo, de un vistazo ves quién está trabajando y quién está parado. Cuando uno termina, le das la siguiente tarea al momento.

03Problemas reales al probarlo

Lo que nos pasó al instalarlo en Windows con Node.js 22 y cómo se resolvió.

Lo que nos pasó al probarlo
Los personajes no se mueven

La primera vez, Pixel Agents arranca pero avisa que los hooks no están instalados: para escribir en la configuración de Claude Code necesita que lo apruebes una sola vez. Abrí la URL que imprime (la que trae ?token=) y aprobalo desde el navegador. Sin eso, la oficina detecta a los agentes leyendo sus registros y va con demora.

Lo que nos pasó al probarlo
La dirección cambia cada vez que lo abrís

Sin opciones, Pixel Agents elige un puerto distinto en cada arranque y el link guardado deja de andar. Por eso el prompt lo arranca con un puerto fijo (--port 3100). Si ese puerto está ocupado, pedile a Claude Code que use otro.

Nota
El link con token es privado

El token de la URL permite lanzar agentes y aprobar cambios en tu configuración. No lo pegues en grupos ni lo compartas: para mostrar la oficina, compartí una captura.

¿Lo querés a medida para tu negocio?

Armo sistemas y agentes de IA, y doy consultorías y asesorías para equipos en Latinoamérica y España.

Trabajar conmigo
Seguí con estos
RecursosTrabajar conmigo

¿Qué estás precisando ahora mismo?

Automatizar procesos en mi negocio.
→
Aprender de IA.consultorías y asesorías
→
Un proyecto más grande. Tengo presupuesto.agentes, sistemas, una construcción completa
→

Se abre WhatsApp con el mensaje ya escrito. Lo hablamos por ahí y coordinamos una llamada.