Sede Virtual Disoftx HQ — Investigación GitHub (proyectos open-source replicables)
Autor: Nexus (subagente de investigación)
Fecha: 2026-09-20
Objetivo: Encontrar proyectos open-source existentes que hagan "oficina virtual isométrica con agentes de IA en escritorios (estados idle/working/thinking/error)" para replicar/adaptar y NO reinventar.
Nota de verificación: Todos los datos de repos (estrellas, forks, licencia, lenguaje, última actividad) fueron consultados en vivo vía GitHub API (
api.github.com) el 2026-09-20. Las URLs de demos se comprobaron concurl(código HTTP). Cuando algo no pudo confirmarse, se marca explícitamente.
1. Resumen ejecutivo
Sí existen proyectos que resuelven (casi) exactamente lo que queremos, y están activos y frescos en 2026. El ecosistema se dividió en dos familias:
- Monitores de agentes de IA en oficina pixel-art — nacieron específicamente para esto: cada agente/coding-agent se convierte en un personaje que se mueve según lo que hace (leer, editar, ejecutar, esperar, bloquearse). Es exactamente nuestro caso de uso.
- Oficinas virtuales colaborativas (tipo Gather/WorkAdventure) — pensadas para humanos con avatar y video-chat por proximidad. Sirven de motor visual pero NO traen el modelo de "estado de agente"; habría que adaptarlas a mano.
Hallazgo clave: existe un proyecto nativo de OpenClaw (ruiqili2/agent-monitor, MIT, TypeScript, Next.js) que ya se conecta al gateway de OpenClaw por WebSocket/SSE, tiene un state-mapper.ts de sesión→estado UI, y renderiza una oficina pixel-art (dice "isometric") con feed de actividad, chat y estadísticas. Es el candidato de menor esfuerzo de integración posible porque nuestra plataforma YA es OpenClaw.
Segundo hallazgo: hay otra integración OpenClaw vía web llamada "My Virtual Office" (eliautobot/my-virtual-office, 326★, pero AGPL-3.0 → cuidado si el HQ es producto comercial).
Recomendación: adaptar el agent-monitor (OpenClaw) como base #1, con KbWen/agent-virtual-office (MIT, SVG puro, sin GPU, sin backend) como base #2 si queremos algo ultraligero controlable, y pixel-agents-hq/pixel-agents (9.3k★, MIT, arquitectura de hooks enchufable) como base #3 para el motor de animación más maduro y popular.
Advertencia general: casi todos estos repos son proyectos recientes (2025–2026), muchos de autor único, con pocas estrellas y posible "vibe-coding". Ninguno es una plataforma madura tipo SAP; hay que leer el código antes de adoptar.
2. Candidatos (verificados vía GitHub API + web)
Estrellas/forks = snapshot 2026-09-20. "Últ. push" = último commit confirmado por API.
2.1 Monitores de agentes en oficina / pixel-art (familia RECOMENDADA)
| # | Proyecto | Repo | ★ | Forks | Licencia | Stack | Qué hace | Demo | Pros / Contras |
|---|---|---|---|---|---|---|---|---|---|
| A | agent-monitor (OpenClaw) | github.com/ruiqili2/agent-monitor |
55 | 13 | MIT | Next.js 16 + TypeScript | Dashboard de visualización/control de agentes para OpenClaw. Oficina pixel-art (dice isometric), 18 comportamientos, chat boss/directo, autowork, state-mapper.ts, SSE desde gateway |
No tiene homepage propia (corre en localhost:3000/plugin :3200) |
✅ Nativo OpenClaw (auto-lee ~/.openclaw/openclaw.json, handshake de device, reconexión). ✅ Mapeo estado→UI ya escrito. ⚠️ Estrellas bajas. ⚠️ El README apunta a otro repo (Franzferdinan51/agent-monitor-openclaw-dashboard, 1★) → posible fork/mirror, verificar cuál es el canónico. ⚠️ Plugin npm @openclaw/agent-monitor NO encontrado en registro npm (404) |
| B | agent-virtual-office | github.com/KbWen/agent-virtual-office |
24 | 11 | MIT | React + SVG puro (sin canvas), Node | Oficina pixel-art donde Claude Code/Codex/Gemini aparecen como "pixel coworkers": teclean, café, se bloquean, "ship". Eventos reales de la sesión. Watchdog, inspector al click, postcard PNG | Sí (npx github:KbWen/agent-virtual-office, sirve en navegador) |
✅ Sin GPU, sin canvas, sin backend, bundle diminuto. ✅ Acepta eventos vía HTTP de cualquier herramienta → ideal para conectar NUESTRO state.json. ✅ MIT. ✅ Muy reciente (push 2026-09-20). ⚠️ Solo 24★, autor único, código pequeño (menos features). ⚠️ Estilo más "plano/frontal" que isométrico real |
| C | pixel-agents | github.com/pixel-agents-hq/pixel-agents |
9354 | 1524 | MIT | TypeScript + canvas | Convierte agentes de terminal en personajes pixel-art en una oficina (caminan al escritorio, teclean al editar, leen al buscar, avisan cuando esperan input). Extensión VS Code + CLI standalone (npx pixel-agents). Editor de oficina, speech bubbles, sonidos, sub-agentes/teams, áreas por carpeta |
Marketplace VS Code + npx pixel-agents (servidor local) |
✅ El más maduro y popular de lejos (9.3k★, 1.5k forks). ✅ Arquitectura agent-agnostic vía HookProvider → añadir un proveedor nuevo = 1 subcarpeta. ✅ MIT. ⚠️ VS Code-first; CLI standalone sirve oficina en navegador pero nace del ecosistema IDE. ⚠️ Canvas (no SVG) — más pesado, aunque 2D sin GPU |
| D | Agent-Quest | github.com/FulAppiOS/Agent-Quest |
139 | 23 | MIT | TypeScript + Bun + WebSocket | Dashboard gamificado: agentes Claude Code/Codex como héroes en una aldea medieval 2D. Según lo que hace el agente, camina a Biblioteca/Forja/Arena. Editor de mapa, feed, auto-discovery de ~/.claude*. Latencia sub-2s por WebSocket/hooks |
No homepage; corre en localhost:4445 |
✅ Patrón estado→edificio = justo lo nuestro (idle/working/thinking/error). ✅ MIT, TS, hooks postToolUse. ⚠️ Ambientación "aldea", no oficina. ⚠️ Requiere Bun |
| E | My Virtual Office | github.com/eliautobot/my-virtual-office |
326 | 72 | AGPL-3.0 | Python (backend) + web 2D | Workspace 2D self-hosted; agentes caminan entre escritorios, café, reuniones. Conecta a OpenClaw (gateway + home dir) y a Hermes/Codex | Sí: myvirtualoffice.ai (HTTP 200) |
✅ Integración OpenClaw real (usa gateway, home dir, SSE). ✅ 326★, activo, Docker. ⚠️ AGPL-3.0 = copyleft fuerte (riesgo si el HQ es producto comercial cerrado). ⚠️ Python + más piezas (gateway, mounts) |
| F | agent-office (Pixel&Process) | github.com/Pixel-Process-UG/agent-office (orig. fwartner/agent-office) |
46 | 15 | MIT | TypeScript (Next + WebSocket) | Oficina pixel-art donde agentes "viven/trabajan/hablan", tareas con prioridad, chat, burbujas, integraciones Slack/GitHub/Linear/Telegram, horas de oficina, decisiones/votación | Sí: agent-office.pixelandprocess.de (HTTP 200) |
✅ Features de gestión real (tareas, Telegram, accesibilidad WCAG). ✅ MIT. ⚠️ Early development, "cosas se romperán". ⚠️ Tileset del mapa es asset de pago (Donarg Office Tileset) — sin él solo hay grid |
2.2 Oficinas virtuales colaborativas (familia "motor visual", para humanoides)
| # | Proyecto | Repo | ★ | Forks | Licencia | Stack | Qué hace | Demo | Pros / Contras |
|---|---|---|---|---|---|---|---|---|---|
| G | SkyOffice | github.com/kevinshen56714/SkyOffice |
1296 | 384 | MIT | Phaser3 + React + Redux + Colyseus + TypeScript | Oficina virtual inmersiva pixel-art con proximity chat, screen sharing, salas, whiteboard (WBO) | Sí: skyoffice.netlify.app (HTTP 200) |
✅ Stack web clásico y bien documentado, MIT. ✅ Ganador de competencia 2021. ⚠️ Diseñado para humanos, no estados de agente. ⚠️ Push 2025-12 (menos fresco) |
| H | WorkAdventure | github.com/workadventure/workadventure |
5788 | 964 | ⚠️ No detectada por API (ver §5) | TypeScript, Phaser, monorepo Docker | Metaverso/oficina 16-bit colaborativa, video-chat por proximidad, mapas editables (Tiled) | Sí: workadventu.re y play staging (HTTP 200) |
✅ Muy popular, GDPR, self-hostable. ⚠️ Infra pesada (docker-compose multi-servicio). ⚠️ Orientado a humanos. ⚠️ Licencia ambigua → verificar |
| I | TinyFloor | github.com/JittoJoseph/TinyFloor |
12 | 5 | AGPL-3.0 | Next.js + React + Phaser + Spring Boot (Java) + MongoDB | Oficina 2D top-down, presencia multiplayer, proximity chat, avatares personalizables | Sí: www.tinyfloor.com (HTTP 200) |
✅ i18n 18 idiomas. ⚠️ AGPL-3.0. ⚠️ Stack pesado (Java + Mongo). ⚠️ Solo 12★, "ready for production" en marketing pero es monorepo joven |
| J | gather-clone | github.com/trevorwrightdev/gather-clone |
72 | — | ⚠️ Sin licencia detectada | Next.js + Pixi.js + Supabase + Socket.io | Clon de Gather.town: espacios custom, video-chat por proximidad | No confirmada | ✅ Pixi.js (render 2D liviano). ⚠️ Sin licencia = legalmente "all rights reserved" por defecto. ⚠️ Push 2025-03 (estancado) |
2.3 Descartados / no verificables
github.com/mckinley-and-rice/virtualoffice— 404 / no existe (la API devolviónull). No usar.alfaXphoori/AgentTrack(0★, Go) ycogniolab/agent-monitor(6★, Python) — son observabilidad/tracing en terminal o backend, NO oficina visual. Fuera de alcance (mencionados por completitud).Arjun-G-Ravi/ai-village(8★, sin licencia, push 2025-01) — simulación de aldea autónoma, no oficina. Descartado.@openclaw/agent-monitoren npm → 404. El plugin referido en el README de (A) no se pudo confirmar publicado.
3. Recomendación TOP 3
🥇 #1 — ruiqili2/agent-monitor (OpenClaw-native, MIT, TS)
Por qué: Es literalmente para OpenClaw. Se conecta al gateway, descubre config en ~/.openclaw/openclaw.json, mantiene WebSocket persistente con auth de device, expone /api/gateway/events por SSE, y ya trae state-mapper.ts (sesión→estado UI) + oficina pixel-art con 18 comportamientos. Cero trabajo para el "feed": no hay que inventar el protocolo, ya está adaptado a nuestra plataforma. Mitiga el riesgo principal del proyecto original (reinventar la integración).
Cuándo NO: si el repo canónico real es el mirror de 1★ y el mantenimiento es dudoso → hacer fork propio y cuidarlo.
🥈 #2 — KbWen/agent-virtual-office (MIT, SVG puro, sin GPU, sin backend)
Por qué: Encaja con TODOS nuestros requisitos técnicos: JS/React, SVG (sin canvas ni GPU), licencia MIT, sin backend ni base de datos, y un endpoint HTTP genérico para inyectar eventos → conectar nuestro state.json es trivial (hacer POST a la oficina cuando cambia el estado de un agente). Bundle diminuto, fácil de leer/editar/guiones, fresco (push hoy). Ideal si queremos control total sobre el look "Disoftx HQ".
Cuándo NO: si queremos muchas features de gestión ya hechas (Chat/tareas/integraciones) o estrictamente isométrico real → es simpler y más "plano".
🥉 #3 — pixel-agents-hq/pixel-agents (MIT, 9.3k★, TS)
Por qué: El proyecto más maduro, popular y con arquitectura de extensión pensada (HookProvider): añadir un proveedor para nuestro feed de estado = una subcarpeta de código. Tiene editor de oficina, speech bubbles, sonidos, sub-agentes y áreas. Es la opción "a prueba de futuro" y con comunidad grande.
Cuándo NO: si queremos algo ultraligero y no arrastrar el ecosistema VS Code/canvas; el CLI standalone existe pero el ADN es IDE-first.
Alternativa fuerte: Si el AGPL no es problema, My Virtual Office (#E) es la #2 natural por su integración OpenClaw documentada (gateway + home dir + SSE + Docker). El problema es la licencia.
4. Plan de replicación (conectar a NUESTRO estado: idle/working/thinking/error)
4.0 Nuestro estado de origen (asumido)
Un state.json (o stream) con, por agente: id, name, role, state ∈ {idle, working, thinking, error}, task, lastEvent, ts. Si es por WebSocket, aún mejor.
4.1 Ruta recomendada (base: agent-monitor OpenClaw-native) — esfuerzo bajo
- Fork/clonar el repo y arrancarlo local:
git clone … && npm install && npm run dev→http://localhost:3000. - Confirmar el canónico: comparar
ruiqili2/agent-monitorvsFranzferdinan51/agent-monitor-openclaw-dashboard; quedarnos con el que tenga commits reales. - Validar auto-conexión contra nuestro gateway OpenClaw: que lea
~/.openclaw/openclaw.json, descubra puerto y autentique con device identity. - Mapear estados: revisar
src/lib/state-mapper.tsy ajustar el mapeo a nuestros 4 estados (idle/working/thinking/error) → colores/anillos/animaciones. - Feed: apuntar el dashboard a nuestras sesiones reales (SSE de
/api/gateway/events). Si necesitamos agentes "que no son sesiones OpenClaw", añadir una fuente extra (ver 4.3). - Reverse-proxy + auth: servir detrás de Nginx con TLS y token (NO exponer
0.0.0.0sin auth). - Deploy en VPS (Docker/PM2), conectar dominio interno del HQ.
Esfuerzo estimado: 0.5–2 días (setup + mapeo de estados + deploy). Casi todo es configuración, no desarrollo.
4.2 Ruta ultraligera (base: agent-virtual-office, SVG) — esfuerzo bajo-medio
- Clonar y correr:
npm install && npm run dev(onpx). - Localizar el endpoint HTTP de ingesta de eventos del server (el README dice "The office reacts to any tool that can send an HTTP request").
- Escribir un puente (script Node/Python ~50–100 líneas) que:
- lea nuestro
state.json(o escuche el WebSocket), - traduzca
idle→coffee/wander,working→typing,thinking→💭,error→blocked, - haga POST del evento con el nombre del agente.
- Personalizar personajes/roles (mapa
rol→sprite) con nuestros agentes (ej. Zephyra/Cyclofun/KbWen-style roles). - Deploy
--no-hosten producción conOFFICE_API_TOKEN(el repo advierte que el dev server NO tiene auth y se expone a la LAN). - Montar el puente como servicio (systemd/cron o el ticker de heartbeat).
Esfuerzo estimado: 1–3 días (puente + personalización de sprites/roles). Código mínimo.
4.3 Ruta "motor profesional" (base: pixel-agents) — esfuerzo medio
- Clonar; correr CLI standalone
npx pixel-agents(o ext. VS Code). - Implementar un
HookProviderpropio (1 subcarpeta) que reciba nuestro estado (idle/working/thinking/error) y lo traduzca a acciones (walk/type/read/blocked). - Mapear
role→characteryworkspace→áreade la oficina. - Usar el editor de oficina para diseñar el layout "Disoftx HQ" y exportarlo.
- Deploy del CLI en el VPS con
--host 127.0.0.1+ reverse proxy/token.
Esfuerzo estimado: 2–5 días (el proveedor de hooks + layout + deploy).
4.4 Contrato de datos sugerido (agnóstico, para cualquiera de las 3 rutas)
{
"agents": [
{"id":"nexus","name":"Nexus","role":"orchestrator","state":"working","task":"research HQ","ts":1789940584},
{"id":"sub-1","name":"Subagente","role":"researcher","state":"thinking","task":"verify repos","ts":1789940585}
]
}
Mapeo canónico propuesto: idle→descanso/café · working→tecleando en escritorio · thinking→burbuja 💭 / pausa · error→alerta roja/bloqueado. Cualquier motor de los 3 acepta esto con un adaptador corto.
5. Riesgos / gotchas
- Licencias copyleft (AGPL-3.0):
my-virtual-office(#E) yTinyFloor(#I) son AGPL. Si el HQ va dentro de un producto/servicio comercial de Zephyra/Cyclofun, AGPL obliga a liberar el código que lo integra. Preferir MIT (A, B, C, D, F, G) salvo decisión consciente. - WorkAdventure — licencia NO confirmada: la API no detectó licencia; el repo tiene componentes con licencias mixtas (open + comercial). Verificar
LICENSE/READMElegal ANTES de usar. Marcado como no verificado. - "Isométrico" vs realidad: varios proyectos se anuncian como isométricos pero son top-down/planos. Solo (A) declara explícitamente render isométrico; (B) es SVG frontal; (C)/(G) son top-down/2D. Si "isométrico" es un requisito duro, validarlo con captura antes de comprometerse.
- Proyectos jóvenes / autor único / "vibe-coded": estrellas bajas y commits recientes. Riesgo de abandono. Recomendación: hacer fork propio de la base elegida y asumir su mantenimiento.
- Repos duplicados/espejo: (A) apunta a otro repo (1★) como origen;
mckinley-and-rice/virtualofficeno existe (404). Confirmar el repo canónico antes de clonar. - Assets con licencia: (F) usa tileset de pago (Donarg). (G) agradece assets de LimeZu ong (revisar términos). (C) usa sprites CC0 (bien). (D) usa pack CC0. Revisar licencia de sprites/tiles por separado del código.
- Exposición de red / auth: varios advierten que el dev server no tiene autenticación y se expone a la LAN. (B) y (C) insisten en
--no-host/token. Nunca exponer0.0.0.0sin TLS+token. - Secretos como capability: (C) advierte que la URL con
?token=es un bearer (cualquiera que la tenga puede aprobar hooks). No pegar en canales compartidos. - Backend/dependencias pesadas: (G) Colyseus+PeerJS, (I) Java+MongoDB+Spring, (H) monorepo Docker multi-servicio, (E) gateway+mounts. Para VPS modesto, priorizar (A)/(B)/(C).
- Dependencia de plataforma: (A) y (E) asumen OpenClaw (perfecto para nosotros, pero acopla el HQ a OpenClaw). Si mañana migramos de plataforma, el adaptador pesa más.
- Plugin npm no publicado:
@openclaw/agent-monitorno existe en el registro npm (404) → no confiar en ese comando de instalación del README de (A). - No reinventar ≠ no adaptar: ninguna opción cubre los 4 estados exactamente de fábrica; el mapeo
idle/working/thinking/errorsiempre requiere un ajuste pequeño (horas, no días).
6. Anexo — Método y trazabilidad
- Búsquedas ejecutadas: "virtual office open source github isometric pixel art agents", "AI agents visualization dashboard live activity monitor github", "isometric office simulation javascript Phaser", "agent-quest/pixel office/AgentOffice github", "open source gather.town clone react phaser" (varias, con
web_search). - Verificación de repos:
GET https://api.github.com/repos/<owner>/<repo>(estrellas, forks, licencia, lenguaje, último push) el 2026-09-20. - Verificación de demos:
curl -s -o /dev/null -w "%{http_code}"→ 200 enmyvirtualoffice.ai,agent-office.pixelandprocess.de,skyoffice.netlify.app,www.tinyfloor.com,workadventu.re. - READMEs revisados vía
web_fetchpara (A)-(J). - No verificados / marcados: licencia de WorkAdventure y gather-clone; existencia/publicación del plugin
@openclaw/agent-monitor; repo canónico de (A) (duplicado); demo en vivo de gather-clone; recuento exacto de estrellas de gather-clone (API devolvió 72★, sin forks).
Fin del informe.