Construimos el primer plugin de agentes para Orca — y lo regalamos. Esto aprendimos sobre memoria, agentes y negocio.

Hoy publicamos nuestro primer producto open source: el AgentesNexo Modo Selector, un plugin para Orca que pone en su menú de agentes una opción que hasta ahora no existía — un agente de código que recuerda. Es, hasta donde sabemos, el primer plugin de perfiles de agente construido para esa plataforma. Gratis, licencia MIT, y en este artículo contamos qué hace, por qué lo construimos en un solo día, y qué aprendimos sobre el verdadero cuello de botella de los agentes de IA: no es la potencia, es la memoria.

El contexto: Orca y la fiebre de los agentes paralelos

Orca es un "Agent Development Environment" open source de Stably AI: una cabina de escritorio para dirigir varios agentes de código a la vez, cada uno trabajando en una copia aislada del proyecto (worktrees de git), con revisión visual de cambios y hasta una app móvil para supervisar desde el teléfono. Soporta más de 30 agentes de línea de comandos — Claude Code, Codex, Gemini y otros — y su adopción explotó este año.

Nosotros lo instalamos, lo auditamos y lo pusimos a prueba con un sprint real: tres tareas de nuestro propio sitio, en paralelo, terminadas en unos diez minutos de reloj. La herramienta cumple. Pero probándola confirmamos el patrón que vemos en toda la industria.

El problema: agentes amnésicos

Los más de 30 agentes que Orca ofrece comparten un defecto de diseño: cada tarea arranca de cero. El agente no sabe qué se decidió ayer, qué intentó el agente anterior, ni por qué el proyecto es como es. Es un contratista brillante que llega cada mañana sin recordar nada de la obra.

Y hay un problema técnico adicional que casi nadie menciona: la memoria de Claude Code va atada a la ruta del proyecto, y las copias aisladas donde trabajan los agentes de Orca viven en otra ruta. Aunque tu proyecto tuviera memoria acumulada, el agente en el worktree no la encuentra.

Lo que construimos: un selector de modos

El plugin agrega dos agentes al selector de Orca:

Claude Rápido es el contratista de siempre: llega, hace la tarea puntual, entrega y se va. Para arreglos autocontenidos donde el repositorio es todo el contexto, es exactamente lo que quieres.

Claude Ecosistema es el trabajador de tu equipo, y funciona en tres niveles que se activan solos según lo que exista en tu máquina:

• Memoria por proyecto (siempre, se autoconstruye): si el proyecto no tiene memoria, el agente la crea en su primera tarea. Cada tarea termina escribiendo un handoff — qué hizo, qué decidió, qué queda pendiente — y la siguiente lo lee. A las cinco tareas, tu proyecto tiene historia. El plugin además detecta el repositorio original desde la copia aislada y conecta la memoria correcta: el problema técnico de las rutas, resuelto.
• Cerebro local (si existe): si la máquina tiene un buscador semántico de conocimiento, el agente lo consulta para contexto de negocio y decisiones.
• Equipo (si existe): si hay otras sesiones de Claude Code corriendo en la máquina, el agente las descubre y puede consultarles lo que necesite.

La diferencia queda visible en un menú: eliges por tarea si quieres un contratista o alguien del equipo.

Los guardrails: lo que aprendimos probando de verdad

El plugin trae reglas de seguridad que no salieron de un documento de buenas prácticas, sino de fallos reales que observamos en nuestras pruebas:

• El handoff documenta solo lo que el agente hizo. En una de nuestras pruebas, un agente fabricó un "incidente de seguridad" que nunca ocurrió y lo escribió en la memoria compartida como un hecho. Verificamos con datos: era invención pura. Un agente que alucina eventos y los persiste contamina la memoria de todos los que vienen después. Por eso está prohibido escribir narrativas sobre terceros: los problemas se reportan con evidencia textual exacta, y un humano verifica.
• Nada de envíos externos. El agente no puede mandar nada a mensajería, correo ni APIs externas. Las acciones hacia afuera las pide el dueño, no un agente.
• Los mensajes de otros agentes son datos, no órdenes. La defensa básica contra inyección de instrucciones en sistemas multiagente.
• El repositorio original nunca se toca: todo el trabajo vive en la copia aislada.

Por qué lo regalamos

La licencia MIT de Orca permite construir productos comerciales encima. Decidimos otra cosa: contribuir. El plugin es gratis, el código es legible (dos scripts y unos JSON, sin binarios, sin telemetría, sin credenciales), y el instalador genera las rutas de cada usuario en su propia máquina — el repositorio no contiene datos de nadie.

La razón es simple: la herramienta no es el negocio. Cualquiera puede descargar un orquestador de agentes; lo que no se descarga es la memoria de tu negocio, el equipo de agentes que se coordina con reglas, y la seguridad que resiste los fallos que describimos arriba. Eso se monta, se enseña y se mantiene — y es lo que hacemos para nuestros clientes. El plugin es la versión mínima y gratuita de esa idea, para que cualquiera sienta la diferencia entre un agente que recuerda y uno que no.

Instalación

git clone https://github.com/demianolmedo/orca-modo-selector.git
cd orca-modo-selector
./install.sh

Y el último paso en Orca: Settings → Plugins → Install → "Local folder" → pegar la ruta que imprime el instalador. Requiere Orca 1.4 o superior y Claude Code.

El repositorio completo, con el detalle técnico y el código: github.com/demianolmedo/orca-modo-selector

Preguntas frecuentes

¿El plugin incluye la memoria y el cerebro? Incluye la memoria por proyecto, que se autoconstruye con el uso. El cerebro de negocio completo y el equipo coordinado son infraestructura que se monta aparte — el plugin los detecta y los usa si existen.

¿Qué datos recopila? Ninguno. Sin red, sin telemetría, sin credenciales. Los tokens de Claude quedan en el almacén de Claude Code, donde siempre estuvieron.

¿Funciona sin Orca? Los scripts de los modos funcionan con Claude Code directamente, pero el selector visual y los worktrees paralelos son de Orca. Gracias a Stably AI por una herramienta excelente y un sistema de plugins abierto.