agent-native-agent
ANA es un agente nativo autocontenido que permite construir y operar aplicaciones observables mediante una interfaz de chat. Funciona como runtime completo, ejecutándose en tmux sin dependencias externas.
Ficha actualizada 23 sept 2026, 1:25 · upstream 23 sept 2026, 1:24 · release sin release detectada
Qué es agent-native-agent
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
ANA (Agent-Native Agent) es un framework para construir aplicaciones operadas por observar su estado visual y conversar con un agente de programación que actúa como motor del sistema. Diferente a los asistentes tradicionales que esperan instrucciones, ANA combina observación visual y conversación natural: el usuario ve el estado en tiempo real, conversa con el agente, y el agente propone cambios que se aplican automáticamente al runtime. Esto elimina la necesidad de PRs o despliegues separados — el agente reescribe el código del app mientras el usuario lo usa.
El sistema está diseñado para ser 'Agent-Native Lifestyle' (ANL): una nueva forma de trabajar, aprender y crear donde el agente es parte integral del flujo de trabajo diario. ANA se construye sobre un runtime único en un solo archivo que puede ejecutarse desde cualquier entorno con tmux, sin dependencias de npm o pip.
La arquitectura se divide en tres capas: la capa UX (dashboard visual), la capa de comunicación (SSE bidireccional entre dashboard y agente) y la capa de lógica del agente (que lee datos, toma decisiones y reescribe el código). El agente actúa como backend completo — no necesita un servidor separado ni conexión a APIs externas. Todo lo que se ejecuta reside en un único archivo de runtime.
- Construir una app de gestión de tareas donde cada cambio de estado sea visible y aplicable en tiempo real
- Crear un dashboard de monitoreo con chat natural para diagnosticar problemas sin necesidad de logs o dashboards tradicionales
- Automatizar flujos de trabajo que requieran cambios iterativos: el agente propone, el usuario aprueba y la app se actualiza sin intervención manual
- Desarrollar interfaces de administración donde cada acción sea reversible y visible en tiempo real para evitar errores humanos
- Crear sistemas de feedback continuo donde los usuarios pueden reportar problemas y ver soluciones aplicadas inmediatamente
- Construir dashboards complejos con múltiples paneles que se actualicen dinámicamente mediante conversación natural
- El runtime es un solo archivo sin dependencias, lo que elimina fricción de configuración en cualquier entorno (macOS, Linux, WSL)
- La arquitectura de 'observar y conversar' permite cambios iterativos sin necesidad de PRs o despliegues separados
- El agente actúa como backend completo: lee datos del sistema, toma decisiones y reescribe el código del app en tiempo real
- Soporte nativo de Chip (context chips) que permite pinar elementos visuales para usarlos como contexto en conversaciones
- Diseño orientado a la observabilidad: cada estado es visible, cada acción es reversible y todo está documentado en un ledger persistente
- Compatible con cualquier dashboard existente mediante el endpoint /api/chat, permitiendo migración gradual sin reescribir toda la UI
- El agente no puede acceder a datos externos (bases de datos, APIs) sin una capa de integración adicional; todo debe ser in-situ
- La aplicación depende del entorno en el que se ejecuta: si el usuario cambia de terminal o de máquina, la sesión se reinicia
- No tiene autenticación nativa ni gestión de sesiones multiusuario; requiere un proxy o gateway externo para múltiples usuarios
- El agente no puede ejecutar comandos de sistema (sudo, shell) directamente sin una capa de abstracción adicional
- La persistencia del estado depende de archivos JSONL en disco; si se pierde la sesión, el progreso se reinicia
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para usar ANA: instala el runtime en tmux con `bash skills/install/scripts/run.sh`, luego ejecuta tu dashboard en un terminal separado. El runtime autoconfigura paneles de scrollback y maneja conexiones SSE. Para múltiples usuarios, añade un header de identidad (ej. X-Forwarded-Email) antes del request al endpoint de chat. No necesitas npm ni build tools: el runtime se ejecuta directamente desde Node.js con `node server.js`. El dashboard puede ser cualquier HTML que envíe POST /api/chat y consuma SSE para recibir respuestas en tiempo real.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.