Omnigent: El Meta-Arnés de Código Abierto para Orquestar Agentes de IA
Omnigent es un meta-arnés de código abierto que unifica Claude Code, Codex, Cursor y agentes personalizados bajo una sola capa de orquestación con aplicación de políticas, sandboxing y colaboración en tiempo real.
¿Qué es Omnigent?
Omnigent es un meta-arnés de código abierto para agentes de IA. Piénsalo como un control remoto universal para tus agentes de codificación: en lugar de manejar CLIs, configuraciones y credenciales separadas para Claude Code, Codex, Cursor, OpenCode, Hermes, Pi y cualquier agente personalizado que construyas, Omnigent te ofrece una sola capa de orquestación que los une a todos.
La idea central es simple pero poderosa: intercambia o combina arneses de agentes sin reescribir nada. Defines tus agentes en YAML, estableces políticas que gobiernan su comportamiento y los ejecutas desde cualquier dispositivo: terminal, navegador, teléfono o la aplicación nativa de macOS. Las sesiones te siguen, los subagentes colaboran y todo se mantiene sincronizado.
Por Qué Esto Importa
Si has trabajado con múltiples agentes de codificación de IA, has sentido el dolor. Cada uno tiene su propio CLI, su propia gestión de credenciales, su propio modelo de sandboxing (o la falta de él). Cambiar entre ellos significa cambiar de contexto. Combinarlos significa unir con cinta scripts que apenas funcionan.
Omnigent resuelve esto proporcionando una capa de orquestación común que:
- Unifica múltiples agentes en una sola sesión. Mezcla Claude Code, Codex, Cursor y agentes personalizados. Pide a un agente que revise el trabajo de otro, o divide una tarea entre agentes que sobresalen en diferentes cosas.
- Funciona desde cualquier dispositivo. Inicia una sesión en tu terminal, continúa en el navegador, retómala en tu teléfono. Los mensajes, subagentes, terminales y archivos se mantienen sincronizados.
- Aplica políticas y sandboxing. Crea políticas que pausen para aprobación antes de acciones riesgosas, limiten el gasto o restrinjan qué herramientas puede usar un agente. Las políticas se aplican a nivel de servidor, por agente o por sesión.
- Soporta cualquier modelo. Usa una clave API de primera parte, una suscripción a Claude/ChatGPT o cualquier gateway compatible (OpenRouter, LiteLLM, Ollama, vLLM, Azure).
Inicio Rápido
Instalación
Un comando instala Omnigent y todo lo que necesita:
curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh
O instala manualmente con uv:
uv tool install omnigent
# o: pip install "omnigent"
Usuarios de Homebrew:
brew install omnigent-ai/tap/omnigent
Inicia Tu Primer Agente
omnigent
Esto selecciona un modelo contigo e inicia una sesión en tu terminal. También lanza una interfaz web local en http://localhost:6767 que muestra la misma sesión en el navegador, o en un teléfono en tu red.
También puedes lanzar un runtime de agente específico:
omnigent claude # Claude Code
omnigent codex # Codex
omnigent cursor # Cursor
omnigent opencode # OpenCode
omnigent hermes # Hermes Agent (Nous Research)
omnigent pi # Pi
Agentes de Ejemplo
Dos agentes de ejemplo vienen con el repositorio:
omnigent run examples/polly/
omnigent run examples/debby/
Polly es un orquestador de codificación multiagente que no escribe código ella misma. Planifica, delega trabajo a subagentes de codificación (Claude Code, Codex o Pi) en worktrees de git paralelos, luego envía cada diff a un revisor de un proveedor diferente al que lo escribió.
Debby es una compañera de lluvia de ideas con dos cabezas: una Claude y una GPT. Cada pregunta va a ambas cabezas, y ella presenta las dos respuestas lado a lado. Escribe /debate y las cabezas se critican mutuamente antes de converger.
Gobernanza de Políticas
Las políticas deciden qué puede hacer un agente: ejecutar comandos de shell, editar archivos, gastar tokens. Verifican cada acción y la permiten, la bloquean o se pausan para preguntarte primero.
En la interfaz web, abre el panel de información de una sesión para explorar las políticas disponibles y activarlas o desactivarlas. En el chat, solo pregunta: "Agrega una política que me pregunte antes de ejecutar comandos de shell." El agente la configura por ti.
Para valores predeterminados del servidor, defínelos en la configuración del servidor o en el YAML de un agente:
policies:
approve_shell:
type: function
handler: omnigent.policies.builtins.safety.ask_on_os_tools
cap_calls:
type: function
handler: omnigent.policies.builtins.safety.max_tool_calls_per_session
factory_params:
limit: 50
budget:
type: function
handler: omnigent.policies.builtins.cost.cost_budget
factory_params:
max_cost_usd: 5.00
ask_thresholds_usd: [3.00]
Las políticas se apilan en tres niveles: a nivel de servidor (admin), por agente (desarrollador) y por sesión (tú), con reglas de sesión más estrictas verificadas primero.
Escribiendo Tu Propio Agente
Un agente es un archivo YAML corto: tu prompt, tus herramientas — funciones locales de Python, servidores MCP y subagentes a los que un supervisor puede delegar.
name: my_agent
prompt: Eres un analista de datos útil.
executor:
harness: claude-sdk
tools:
word_count:
type: function
callable: mypackage.mymodule.word_count
docs:
type: mcp
url: https://example.com/mcp
researcher:
type: agent
prompt: Busca información relevante y resúmela.
tools:
word_count: inherit
Ejecútalo con:
omnigent run path/to/my_agent.yaml
Despliegue
Ejecuta Omnigent en un servidor con una URL estable y tus sesiones serán accesibles desde cualquier lugar, incluido tu teléfono. Un solo docker compose up ejecuta el servidor en cualquier host que tengas (VPS, servidor doméstico). Render y Railway se despliegan con un clic. Fly.io, Hugging Face Spaces, Modal, Cloudflare (sin servidor, escala a cero) y Databricks Apps también están cubiertos.
Colaboración
Omnigent soporta cuentas multiusuario. Habilita la autenticación con:
OMNIGENT_AUTH_ENABLED=1 omnigent server start
Comparte una sesión en vivo a través de la interfaz web, conduce en equipo con omnigent attach <session_id>, o bifurca una conversación para continuar de forma independiente con omnigent run --fork <session_id>.
Conclusión
Omnigent todavía está en alfa, pero ya es una herramienta poderosa para cualquiera que trabaje con múltiples agentes de codificación de IA. Al proporcionar una capa de orquestación unificada con gobernanza de políticas, sandboxing y colaboración en tiempo real, resuelve problemas reales que los desarrolladores enfrentan a diario. La naturaleza de código abierto significa que puedes extenderlo, contribuir a él y dar forma a su futuro.
Visita el repositorio de GitHub para comenzar.