🔗 Nexus

← Volver a notas
18 KB 20/09/2026 16:44
🔗

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 con curl (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:

  1. 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.
  2. 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


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

  1. Fork/clonar el repo y arrancarlo local: git clone … && npm install && npm run dev → http://localhost:3000.
  2. Confirmar el canónico: comparar ruiqili2/agent-monitor vs Franzferdinan51/agent-monitor-openclaw-dashboard; quedarnos con el que tenga commits reales.
  3. Validar auto-conexión contra nuestro gateway OpenClaw: que lea ~/.openclaw/openclaw.json, descubra puerto y autentique con device identity.
  4. Mapear estados: revisar src/lib/state-mapper.ts y ajustar el mapeo a nuestros 4 estados (idle/working/thinking/error) → colores/anillos/animaciones.
  5. 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).
  6. Reverse-proxy + auth: servir detrás de Nginx con TLS y token (NO exponer 0.0.0.0 sin auth).
  7. 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

  1. Clonar y correr: npm install && npm run dev (o npx).
  2. 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").
  3. Escribir un puente (script Node/Python ~50–100 líneas) que:
  4. lea nuestro state.json (o escuche el WebSocket),
  5. traduzca idle→coffee/wander, working→typing, thinking→💭, error→blocked,
  6. haga POST del evento con el nombre del agente.
  7. Personalizar personajes/roles (mapa rol→sprite) con nuestros agentes (ej. Zephyra/Cyclofun/KbWen-style roles).
  8. Deploy --no-host en producción con OFFICE_API_TOKEN (el repo advierte que el dev server NO tiene auth y se expone a la LAN).
  9. 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

  1. Clonar; correr CLI standalone npx pixel-agents (o ext. VS Code).
  2. Implementar un HookProvider propio (1 subcarpeta) que reciba nuestro estado (idle/working/thinking/error) y lo traduzca a acciones (walk/type/read/blocked).
  3. Mapear role→character y workspace→área de la oficina.
  4. Usar el editor de oficina para diseñar el layout "Disoftx HQ" y exportarlo.
  5. 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

  1. Licencias copyleft (AGPL-3.0): my-virtual-office (#E) y TinyFloor (#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.
  2. WorkAdventure — licencia NO confirmada: la API no detectó licencia; el repo tiene componentes con licencias mixtas (open + comercial). Verificar LICENSE/README legal ANTES de usar. Marcado como no verificado.
  3. "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.
  4. 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.
  5. Repos duplicados/espejo: (A) apunta a otro repo (1★) como origen; mckinley-and-rice/virtualoffice no existe (404). Confirmar el repo canónico antes de clonar.
  6. 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.
  7. 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 exponer 0.0.0.0 sin TLS+token.
  8. 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.
  9. 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).
  10. 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.
  11. Plugin npm no publicado: @openclaw/agent-monitor no existe en el registro npm (404) → no confiar en ese comando de instalación del README de (A).
  12. No reinventar ≠ no adaptar: ninguna opción cubre los 4 estados exactamente de fábrica; el mapeo idle/working/thinking/error siempre requiere un ajuste pequeño (horas, no días).

6. Anexo — Método y trazabilidad

Fin del informe.