Skip to main content
Glama

AI Coding Orchestrator (aico V2)

A production-quality local CLI application designed to orchestrate specialized coding agents:

  • Codex CLI β†’ Lead Software Architect, Core Developer, and Complex Problem Solver.

  • Antigravity / AGY CLI β†’ Quality Assurance, Reviewer, Regression Tester, and Small-Fix Agent.

  • Extended Agents β†’ Claude, Gemini, and Local LLMs (via Ollama / OpenAI-compatible endpoints).

aico manages state machines, workflow transitions, Git worktree isolation, prompt templating, parallel test execution, AST security scanning, human-in-the-loop approvals, MCP server integration, and comprehensive reporting.


πŸ—οΈ Architecture

                    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                    β”‚      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

πŸš€ V2 Features & Enhancements

  1. 🌿 Zero-Impact Git Worktree Isolation (--worktree / -w):

    • Executes all agent actions inside an isolated Git worktree without touching your active editor files or unstaged changes.

    • Automatically syncs and merges when the task completes successfully.

  2. ⚑ Parallel Quality & Test Engine (aico test):

    • Concurrently executes Unit Tests, Linters (ruff/eslint), Typecheckers (mypy/tsc), Builds, and Security Audits in worker thread pools.

  3. πŸ›‘οΈ Built-in AST & Static Security Scanner (aico scan):

    • Real-time detection of SQL Injection risks, command injection (shell=True), hardcoded JWT secrets, weak cryptography (MD5/SHA1), and unsafe dynamic execution (eval/exec).

  4. πŸ”Ά Human-In-The-Loop (HITL) Mode (--interactive / -i):

    • Interactive checkpoint approval before architectural changes or security fixes with direct prompt guidance injection ([A]pprove, [E]dit guidance, [R]eject, [Q]uit).

  5. 🎯 Granular Multi-Tier Model Routing:

    • Configure distinct models per phase (e.g. o3-mini / claude-3-7-sonnet for architecture, gemini-2.0-flash for test review, gpt-4o-mini for small fixes).

  6. πŸ”Œ Model Context Protocol (MCP) Server (aico mcp):

    • Run aico as a standard MCP server for seamless integration with Cursor, Antigravity IDE, Claude Desktop, and other MCP clients.

  7. πŸ€– Extended Agent Support:

    • Built-in adapters for Claude CLI, Gemini CLI, and Local LLMs (Ollama / OpenAI-compatible).


πŸ“¦ Installation & Setup

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

Verify installation:

aico doctor

πŸ’» CLI Command Reference

Command

Description

aico

Launch interactive prompt session

aico "task"

Run a direct task in current working directory

aico run "task"

Explicit task run

aico run -w "task"

Run in an isolated Git worktree (zero-impact)

aico run -i "task"

Run with Interactive Human-In-The-Loop checkpoints

aico test

Run parallel test, lint, typecheck, build, and security checks

aico scan

Run static AST & regex security vulnerability scan

aico mcp

Start Model Context Protocol (MCP) JSON-RPC stdio server

aico resume

Resume interrupted task from saved .ai-orchestrator/state.json

aico status

Inspect current task state, iterations, and metrics

aico logs

View unified logs (--agent codex, --agent agy)

aico stop

Abort and cancel active task

aico config show

View current configuration

aico config set <key> <val>

Update configuration key

aico doctor

Run health checks for Codex, AGY, and Git


βš™οΈ Configuration (~/.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

πŸ“‚ Workspace Layout

.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

πŸ§ͺ Test Suite

Run the full test suite covering all V1 and V2 capabilities:

pytest -v

65 unit & integration tests pass with 100% success rate.

F
license - not found
Not graded
quality - not tested
C
maintenance

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

  • 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
  • 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.
  • 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

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

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

  • 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