Skip to main content
Glama
deenesjakoruzh
ram-singh1

aico

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

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

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.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