aico
Runs ESLint as part of the parallel quality testing engine to lint JavaScript/TypeScript code and identify issues.
Provides zero-impact Git worktree isolation, branch management, and snapshotting for safe execution and merging of agent changes.
Integrates local LLMs via Ollama's OpenAI-compatible endpoints, enabling them to act as extended coding agents in the orchestration process.
Integrates OpenAI-compatible endpoints to use OpenAI models as extended coding agents for various phases like review, testing, and small fixes.
Runs Ruff as part of the parallel quality testing engine to lint Python code and identify issues.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@aicoRefactor the auth module in an isolated worktree and run tests and security scan"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
πΏ 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.
β‘ Parallel Quality & Test Engine (
aico test):Concurrently executes Unit Tests, Linters (
ruff/eslint), Typecheckers (mypy/tsc), Builds, and Security Audits in worker thread pools.
π‘οΈ 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).
πΆ 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).
π― Granular Multi-Tier Model Routing:
Configure distinct models per phase (e.g.
o3-mini/claude-3-7-sonnetfor architecture,gemini-2.0-flashfor test review,gpt-4o-minifor small fixes).
π Model Context Protocol (MCP) Server (
aico mcp):Run
aicoas a standard MCP server for seamless integration with Cursor, Antigravity IDE, Claude Desktop, and other MCP clients.
π€ 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 |
| Launch interactive prompt session |
| Run a direct task in current working directory |
| Explicit task run |
| Run in an isolated Git worktree (zero-impact) |
| Run with Interactive Human-In-The-Loop checkpoints |
| Run parallel test, lint, typecheck, build, and security checks |
| Run static AST & regex security vulnerability scan |
| Start Model Context Protocol (MCP) JSON-RPC stdio server |
| Resume interrupted task from saved |
| Inspect current task state, iterations, and metrics |
| View unified logs ( |
| Abort and cancel active task |
| View current configuration |
| Update configuration key |
| 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 -v65 unit & integration tests pass with 100% success rate.
This server cannot be installed
Maintenance
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
- FlicenseBqualityCmaintenanceEnables multi-worker autonomous agent orchestration: decompose complex tasks, run parallel workers, auto-review, and generate follow-up tasks via the Model Context Protocol.8
- FlicenseNot gradedqualityCmaintenanceEquips AI coding agents with filesystem, Git, database, and computation tools via the Model Context Protocol.1
- FlicenseNot gradedqualityBmaintenanceEnables 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.
- AlicenseAqualityBmaintenanceDelegate coding tasks to external AI coding agents in isolated git worktrees with independent verification, enabling any MCP client to orchestrate multi-agent workflows.5MIT
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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