F
licenseNot graded
qualityD
maintenanceEquips AI coding agents with filesystem, Git, database, and computation tools via the Model Context Protocol.
1
-
aico
by ram-singh1
AI Coding Orchestrator（aico V2）
プロダクション品質のローカルCLIアプリケーションで、特化型コーディングエージェントをオーケストレーションするために設計されています：
Codex CLI → 主任ソフトウェアアーキテクト、コア開発者、複雑な問題の解決者。
Antigravity / AGY CLI → 品質保証、レビュアー、リグレッションテスター、小規模修正エージェント。
拡張エージェント → Claude、Gemini、ローカルLLM（Ollama / OpenAI互換エンドポイント経由）。
aico は、ステートマシン、ワークフロー遷移、Gitワークツリー分離、プロンプトテンプレート、並列テスト実行、ASTセキュリティスキャン、Human-in-the-Loop承認、MCPサーバー統合、包括的なレポートを管理します。
🏗️ アーキテクチャ
┌────────────────────────┐
│ 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
🚀 V2の機能と拡張
🌿 ゼロインパクトなGitワークツリー分離（
--worktree/-w）：アクティブなエディタのファイルやステージされていない変更に触れることなく、分離されたGitワークツリー内で全エージェントアクションを実行します。
タスクが正常に完了すると、自動的に同期してマージします。
⚡ 並列品質・テストエンジン（
aico test）：ユニットテスト、リンター（
ruff/eslint）、型チェッカー（mypy/tsc）、ビルド、セキュリティ監査をワーカースレッドプールで並行実行します。
🛡️ 組み込みAST・静的セキュリティスキャナ（
aico scan）：SQLインジェクションのリスク、コマンドインジェクション（
shell=True）、ハードコードされたJWTシークレット、脆弱な暗号化（MD5/SHA1）、安全でない動的実行（eval/exec）をリアルタイムに検出します。
🔶 Human-In-The-Loop（HITL）モード（
--interactive/-i）：アーキテクチャ変更やセキュリティ修正の前に、プロンプトへの直接ガイダンス注入を伴う対話型チェックポイント承認を実施します（
[A]pprove、[E]dit guidance、[R]eject、[Q]uit）。
🎯 きめ細かいマルチティアモデルルーティング：
フェーズごとに異なるモデルを設定できます（例：アーキテクチャには
o3-mini/claude-3-7-sonnet、テストレビューにはgemini-2.0-flash、小規模修正にはgpt-4o-mini）。
🔌 Model Context Protocol（MCP）サーバー（
aico mcp）：aicoを標準のMCPサーバーとして実行し、Cursor、Antigravity IDE、Claude Desktop、その他のMCPクライアントとシームレスに統合できます。
🤖 拡張エージェントサポート：
Claude CLI、Gemini CLI、ローカルLLM（Ollama / OpenAI互換）用の組み込みアダプターを備えています。
📦 インストールとセットアップ
cd /var/www/html/ai-coding-orchestrator
pip install -e .インストールの確認：
aico doctor💻 CLIコマンドリファレンス
コマンド | 説明 |
| 対話型プロンプトセッションを起動 |
| カレントディレクトリで直接タスクを実行 |
| 明示的なタスク実行 |
| 分離されたGitワークツリーで実行（ゼロインパクト） |
| 対話型Human-In-The-Loopチェックポイント付きで実行 |
| テスト、リンター、型チェック、ビルド、セキュリティチェックを並列実行 |
| 静的AST＆正規表現によるセキュリティ脆弱性スキャンを実行 |
| Model Context Protocol（MCP）JSON-RPC stdioサーバーを起動 |
| 保存された |
| 現在のタスク状態、イテレーション、メトリクスを確認 |
| 統合ログを表示（ |
| アクティブなタスクを中止してキャンセル |
| 現在の設定を表示 |
| 設定キーを更新 |
| Codex、AGY、Gitのヘルスチェックを実行 |
⚙️ 設定（~/.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📂 ワークスペース構成
.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🧪 テストスイート
V1およびV2の全機能をカバーする完全なテストスイートを実行：
pytest -v65件のユニットテストと統合テストが100%の成功率で合格します。
This server cannot be deployed
Maintenance
ActivityStale
ResponsivenessNo issues
Related MCP Connectors
AI work orchestration for plans, tasks, teams, and coding-agent dispatch.
The AI orchestration agent for modern software teams.
Cross-agent artifact workspace with provenance across Claude Code, Codex, Cursor, LangGraph.
AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
Related MCP Servers
- AlicenseAqualityCmaintenanceDelegate coding tasks to external AI coding agents in isolated git worktrees with independent verification, enabling any MCP client to orchestrate multi-agent workflows.5MIT
- AlicenseBqualityCmaintenanceProvides 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.32MIT
- AlicenseAqualityBmaintenanceEnables supervising and orchestrating local coding agents like Muse and AGY through a client-agnostic MCP interface, with isolated Git worktrees, safe execution, and deterministic verification.107 npmMIT