Skip to main content
Glama
deenesjakoruzh
ram-singh1

aico

by ram-singh1
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Orquestador de Codificación con IA (aico V2)

Una aplicación CLI local de calidad de producción diseñada para orquestar agentes de codificación especializados:

  • Codex CLI → Arquitecto de Software Principal, Desarrollador Principal y Solucionador de Problemas Complejos.

  • Antigravity / AGY CLI → Aseguramiento de Calidad, Revisor, Probador de Regresión y Agente de Pequeñas Correcciones.

  • Agentes Extendidos → Claude, Gemini y LLMs Locales (a través de endpoints compatibles con Ollama / OpenAI).

aico gestiona máquinas de estado, transiciones de flujo de trabajo, aislamiento de worktree de Git, plantillas de prompts, ejecución paralela de pruebas, escaneo de seguridad AST, aprobaciones human-in-the-loop, integración de servidor MCP e informes completos.

🏗️ Arquitectura

                    ┌────────────────────────┐
                    │      USER / CLI        │
                    │         (aico)         │
                    └───────────┬────────────┘
                                │
                        TASK RECEIVED
                                │
                    ┌───────────▼────────────┐
                    │  GIT & WORKTREE CHECK  │
                    │ Zero-Impact Isolation  │
                    └───────────┬────────────┘
                                │
                    ┌───────────▼────────────┐
                    │       CODEX CLI        │
                    │  • Architecture Design │
                    │  • Core Implementation │
                    │  • Complex Fixes       │
                    └───────────┬────────────┘
                                │
                    ┌───────────▼────────────┐
                    │        AGY CLI         │
                    │  • Review & Test Plan  │
                    │  • Parallel Validation │
                    │  • AST Security Audit  │
                    │  • Issue Classification│
                    └───────────┬────────────┘
                                │
                 ┌──────────────┴──────────────┐
                 │ Issue Classification Branch │
                 └──────────────┬──────────────┘
                                │
       ┌────────────────────────┼────────────────────────┐
       │                        │                        │
     PASS                   SMALL_FIX           COMPLEX / ARCH / BUG / SEC
       │                        │                        │
       ▼                        ▼                        ▼
PARALLEL VALIDATION          AGY FIX                 CODEX FIX
(Test, Lint, Type,           (Local)                 (Deep Fix)
 Build, Security)               │                        │
       │                        ▼                        ▼
       ▼                    AGY RETEST               AGY RETEST
     DONE                       │                        │
                                └─────────►◄─────────────┘

Related MCP server: MCP Server Toolkit

🚀 Características y Mejoras de V2

  1. 🌿 Aislamiento de Worktree de Git de Cero Impacto (--worktree / -w):

    • Ejecuta todas las acciones del agente dentro de un worktree de Git aislado sin tocar los archivos de tu editor activo ni los cambios no preparados.

    • Sincroniza y fusiona automáticamente cuando la tarea se completa con éxito.

  2. ⚡ Motor de Calidad y Pruebas en Paralelo (aico test):

    • Ejecuta simultáneamente Pruebas Unitarias, Linters (ruff/eslint), Verificadores de Tipos (mypy/tsc), Compilaciones y Auditorías de Seguridad en grupos de hilos de trabajo.

  3. 🛡️ Escáner de Seguridad Estático y AST Integrado (aico scan):

    • Detección en tiempo real de riesgos de Inyección SQL, inyección de comandos (shell=True), secretos JWT codificados, criptografía débil (MD5/SHA1) y ejecución dinámica insegura (eval/exec).

  4. 🔶 Modo Human-In-The-Loop (HITL) (--interactive / -i):

    • Aprobación interactiva de puntos de control antes de cambios arquitectónicos o correcciones de seguridad con inyección directa de guía de prompt ([A]probar, [E]ditar guía, [R]echazar, [S]alir).

  5. 🎯 Enrutamiento de Modelos Multi-Nivel Granular:

    • Configura modelos distintos por fase (por ejemplo, o3-mini / claude-3-7-sonnet para arquitectura, gemini-2.0-flash para revisión de pruebas, gpt-4o-mini para correcciones pequeñas).

  6. 🔌 Servidor de Protocolo de Contexto de Modelo (MCP) (aico mcp):

    • Ejecuta aico como un servidor MCP estándar para una integración perfecta con Cursor, Antigravity IDE, Claude Desktop y otros clientes MCP.

  7. 🤖 Soporte de Agentes Extendidos:

    • Adaptadores integrados para Claude CLI, Gemini CLI y LLMs Locales (compatibles con Ollama / OpenAI).

📦 Instalación y Configuración

cd /var/www/html/ai-coding-orchestrator
pip install -e .

Verifica la instalación:

aico doctor

💻 Referencia de Comandos CLI

Comando

Descripción

aico

Iniciar sesión de prompt interactiva

aico "tarea"

Ejecutar una tarea directa en el directorio de trabajo actual

aico run "tarea"

Ejecución explícita de tarea

aico run -w "tarea"

Ejecutar en un worktree de Git aislado (cero impacto)

aico run -i "tarea"

Ejecutar con puntos de control interactivos Human-In-The-Loop

aico test

Ejecutar pruebas, lint, verificación de tipos, compilación y comprobaciones de seguridad en paralelo

aico scan

Ejecutar escaneo estático de vulnerabilidades de seguridad con AST y regex

aico mcp

Iniciar servidor stdio JSON-RPC del Protocolo de Contexto de Modelo (MCP)

aico resume

Reanudar tarea interrumpida desde .ai-orchestrator/state.json guardado

aico status

Inspeccionar el estado actual de la tarea, iteraciones y métricas

aico logs

Ver registros unificados (--agent codex, --agent agy)

aico stop

Abortar y cancelar tarea activa

aico config show

Ver configuración actual

aico config set <clave> <valor>

Actualizar clave de configuración

aico doctor

Ejecutar comprobaciones de salud para Codex, AGY y Git

⚙️ Configuración (~/.aico/config.yaml)

codex:
  command: "codex"
  timeout: 3600
  flags: ["exec", "--dangerously-bypass-approvals-and-sandbox"]
  model: null
  architecture_model: null
  implementation_model: null
  fix_model: null

agy:
  command: "agy"
  timeout: 1800
  flags: ["--print", "--dangerously-skip-permissions"]
  model: null
  review_model: null
  testing_model: null
  fix_model: null

workflow:
  max_iterations: 5
  max_codex_attempts: 5
  max_agy_attempts: 5
  auto_resume: false
  stop_on_environment_issue: true
  interactive: false
  require_approval_on_architecture: false
  require_approval_on_security: false

git:
  enabled: true
  create_branch: true
  branch_prefix: "ai-orchestrator"
  auto_stash_uncommitted: false
  use_worktree: false

testing:
  run_tests: true
  run_lint: true
  run_typecheck: true
  run_build: true
  run_security_scan: true
  parallel: true
  max_workers: 4

safety:
  protect_uncommitted_changes: true
  allow_destructive_git: false

📂 Estructura del Espacio de Trabajo

.ai-orchestrator/
├── state.json           # Machine-readable task state and transition history
├── task.md              # Original user task
├── architecture.md      # Architecture design from Codex
├── final-report.md      # Comprehensive post-task markdown report
│
├── codex/
│   ├── prompt.md        # Prompt sent to Codex
│   ├── result.md        # Codex execution summary
│   └── issues.md        # Issues addressed
│
├── agy/
│   ├── prompt.md        # Prompt sent to AGY
│   ├── test-plan.md     # Test plan created by AGY
│   ├── result.md        # AGY validation results
│   ├── issues.md        # Issues detected
│   └── fixes.md         # Small fixes applied
│
├── logs/
│   ├── orchestrator.log # Workflow state transitions
│   ├── codex.log        # Raw stdout/stderr of Codex
│   └── agy.log          # Raw stdout/stderr of AGY
│
├── worktrees/           # Isolated git worktrees (when enabled)
└── checkpoints/         # Git snapshots before major stages

🧪 Suite de Pruebas

Ejecuta la suite de pruebas completa que cubre todas las capacidades de V1 y V2:

pytest -v

65 pruebas unitarias y de integración pasan con una tasa de éxito del 100%.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
F
license - not found
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • random-agent

    randomchips
    F
    license
    B
    quality
    C
    maintenance
    Enables multi-worker autonomous agent orchestration: decompose complex tasks, run parallel workers, auto-review, and generate follow-up tasks via the Model Context Protocol.
    8

  • agent-mcp

    echodeveloperio
    F
    license
    Not graded
    quality
    B
    maintenance
    Enables collaborative software development through a team of specialized AI agents (Architect, Developer, Reviewer, Tester) communicating via the Model Context Protocol, with tools for file management, task tracking, and code review.

  • worker-bridge

    trollbot2012
    A
    license
    A
    quality
    B
    maintenance
    Delegate coding tasks to external AI coding agents in isolated git worktrees with independent verification, enabling any MCP client to orchestrate multi-agent workflows.
    5
    MIT

View all related MCP servers

Related MCP Connectors

  • AgentDrive

    Cross-agent artifact workspace with provenance across Claude Code, Codex, Cursor, LangGraph.

  • Hexis

    Git-backed platform for skills, tools, and context for AI agents

  • ateam-mcp

    Build, validate, and deploy multi-agent AI solutions from any AI environment.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ram-singh1/ai-coding-orchestrator'

If you have feedback or need assistance with the MCP directory API, please join our Discord server