Skip to main content
Glama
deenesjakoruzh
ram-singh1

aico

by ram-singh1
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

AI 코딩 오케스트레이터 (aico V2)

프로덕션 품질의 로컬 CLI 애플리케이션으로, 특화된 코딩 에이전트를 오케스트레이션하도록 설계되었습니다:

  • Codex CLI → 리드 소프트웨어 아키텍트, 핵심 개발자, 복잡한 문제 해결사.

  • Antigravity / AGY CLI → 품질 보증, 리뷰어, 회귀 테스터, 소규모 수정 에이전트.

  • 확장 에이전트 → Claude, Gemini, 로컬 LLM (Ollama / OpenAI 호환 엔드포인트를 통해).

aico는 상태 머신, 워크플로 전환, Git 워크트리 격리, 프롬프트 템플릿, 병렬 테스트 실행, AST 보안 스캔, 인간 개입 승인, 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: MCP Server Toolkit

🚀 V2 기능 및 개선 사항

  1. 🌿 무영향 Git 워크트리 격리 (--worktree / -w):

    • 모든 에이전트 작업을 격리된 Git 워크트리 내에서 실행하여 활성 편집기 파일이나 스테이징되지 않은 변경 사항을 건드리지 않습니다.

    • 작업이 성공적으로 완료되면 자동으로 동기화하고 병합합니다.

  2. ⚡ 병렬 품질 및 테스트 엔진 (aico test):

    • 워커 스레드 풀에서 단위 테스트, 린터(ruff/eslint), 타입체커(mypy/tsc), 빌드, 보안 감사를 동시에 실행합니다.

  3. 🛡️ 내장 AST 및 정적 보안 스캐너 (aico scan):

    • SQL 인젝션 위험, 명령 인젝션(shell=True), 하드코딩된 JWT 시크릿, 취약한 암호화(MD5/SHA1), 안전하지 않은 동적 실행(eval/exec)을 실시간으로 감지합니다.

  4. 🔶 인간 개입(HITL) 모드 (--interactive / -i):

    • 아키텍처 변경 또는 보안 수정 전에 직접 프롬프트 지침 주입([A]pprove, [E]dit guidance, [R]eject, [Q]uit)을 통한 대화형 체크포인트 승인.

  5. 🎯 세분화된 다중 계층 모델 라우팅:

    • 단계별로 별도의 모델을 구성합니다 (예: 아키텍처용 o3-mini / claude-3-7-sonnet, 테스트 리뷰용 gemini-2.0-flash, 소규모 수정용 gpt-4o-mini).

  6. 🔌 모델 컨텍스트 프로토콜(MCP) 서버 (aico mcp):

    • aico를 표준 MCP 서버로 실행하여 Cursor, Antigravity IDE, Claude Desktop 및 기타 MCP 클라이언트와 원활하게 통합합니다.

  7. 🤖 확장 에이전트 지원:

    • Claude CLI, Gemini CLI, 로컬 LLM(Ollama / OpenAI 호환)용 내장 어댑터.

📦 설치 및 설정

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

설치 확인:

aico doctor

💻 CLI 명령 참조

Command

Description

aico

대화형 프롬프트 세션 시작

aico "task"

현재 작업 디렉토리에서 직접 작업 실행

aico run "task"

명시적 작업 실행

aico run -w "task"

격리된 Git 워크트리에서 실행 (무영향)

aico run -i "task"

대화형 인간 개입 체크포인트로 실행

aico test

병렬 테스트, 린트, 타입체크, 빌드, 보안 검사 실행

aico scan

정적 AST 및 정규식 보안 취약점 스캔 실행

aico mcp

모델 컨텍스트 프로토콜(MCP) JSON-RPC stdio 서버 시작

aico resume

저장된 .ai-orchestrator/state.json에서 중단된 작업 재개

aico status

현재 작업 상태, 반복, 메트릭 검사

aico logs

통합 로그 보기 (--agent codex, --agent agy)

aico stop

활성 작업 중단 및 취소

aico config show

현재 구성 보기

aico config set <key> <val>

구성 키 업데이트

aico doctor

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 -v

65개의 단위 및 통합 테스트가 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