Skip to main content
Glama
deenesjakoruzh
ram-singh1

aico

by ram-singh1
OverviewSchemaSourceRelated ServersDiscussionsAdmin
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: worker-bridge

🚀 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 deployed

Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • worker-bridge

    trollbot2012
    A
    license
    A
    quality
    C
    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

  • dpr-mcp

    Charan-Sharan
    A
    license
    B
    quality
    C
    maintenance
    Provides a Model Context Protocol interface for secure, multi-agent collaboration on Git repositories, offering isolated workspaces, change requests, reviews, and approval workflows with Git as the source of truth.
    32
    MIT