병렬 AI 코딩 에이전트를 위한 오케스트레이션 레이어
요약
병렬 AI 코딩 에이전트를 감독하고 제어하는 에이전틱 IDE 오케스트레이션 레이어입니다. 격리된 워크스페이스와 자동 피드백 루프를 통해 CI 실패나 머지 충돌 등을 에이전트에게 자동으로 라우팅합니다.
핵심 포인트
- Claude Code, Cursor 등 23개 이상의 에이전트와 호환되는 플랫폼
- 격리된 워크스페이스와 전용 런타임을 통한 안전한 실행 환경 제공
- CI 실패 및 리뷰 코멘트를 에이전트에게 전달하는 자동 피드백 루팅
- SQLite 기반의 내구성 있는 사실 저장소 및 실시간 CDC 브로드캐스팅 지원
병렬 AI 코딩 에이전트를 위한 오케스트레이션 레이어 (The orchestration layer for parallel AI coding agents)
격리된 워크스페이스에서 병렬 AI 코딩 에이전트를 감독하며, CI 실패, 리뷰 코멘트, 머지 충돌(merge conflicts)로부터 완전한 제어와 자동 피드백 루프를 제공하는 에이전틱 IDE (Agentic IDE)입니다.
기능 (Features) • 빠른 시작 (Quick Start) • 아키텍처 (Architecture) • 문서 (Documentation) • 기여하기 (Contributing)
| 기능 | 설명 |
|---|---|
| 에이전트 불가지론적 플랫폼 (Agent-Agnostic Platform) | Claude Code, OpenAI Codex, Cursor, OpenCode, Aider, Amp, Goose, GitHub Copilot, Grok, Qwen Code, Kimi Code, Cline, Continue, Kiro 등을 포함한 23개 이상의 에이전트 어댑터 |
| 격리된 워크스페이스 (Isolated Workspaces) | 각 세션은 전용 런타임(runtime)과 함께 자체적인 git worktree로 생성됨 |
| 플랫폼 네이티브 런타임 (Platform-Native Runtimes) | 최적의 성능을 위해 Darwin/Linux에서는 tmux, Windows에서는 conpty 사용 |
| 실시간 PR 관찰 (Live PR Observation) | 자동 피드백 라우팅을 지원하는 공급자 중립적 SCM 옵저버 |
| 자동 피드백 라우팅 (Automatic Feedback Routing) | CI 실패, 리뷰 코멘트, 머지 충돌(merge conflicts)을 해당 에이전트에게 라우팅 |
| 내구성 있는 사실 저장소 (Durable Facts Storage) | SQLite를 통해 불변의 사실(immutable facts)을 영구 저장하며, 읽기 시점에 파생된 표시 상태를 제공 |
| CDC 브로드캐스팅 (CDC Broadcasting) | DB 트리거가 변경 사항을 change_log에 추가하며, SSE를 통해 브로드캐스트됨 |
| 데스크톱 경험 (Desktop Experience) | React UI와 실시간 터미널 스트리밍을 갖춘 네이티브 Electron 앱 |
| 루프백 전용 데몬 (Loopback-Only Daemon) | 설계상 인증(auth), CORS 또는 TLS 없이 127.0.0.1을 통한 HTTP 제어 |
Claude Code, OpenAI Codex, Cursor, OpenCode, Aider, Amp, Goose, GitHub Copilot, Grok, Qwen Code, Kimi Code, Crush, Cline, Droid, Devin, Auggie, Continue, Kiro, Kilo Code를 포함한 23개 이상의 CLI 기반 코딩 에이전트와 함께 작동합니다.
터미널에서 실행된다면, Agent Orchestrator에서도 실행됩니다.
| 요구 사항 | 최소 | 권장 |
|---|---|---|
| Go | 1.25+ | 최신 버전 |
| ... | ||
| 선택 사항: |
tmux
(Darwin/Linux) - Unix 런타임을 위해
gh
(GitHub CLI) - 인증된 GitHub API 호출을 위해
사용자의 플랫폼에 맞는 최신 릴리스를 다운로드하세요:
| 플랫폼 | 다운로드 |
|---|---|
| Windows | Setup.exe |
| macOS | Agent Orchestrator.dmg |
| Linux | Agent Orchestrator.AppImage |
직접 다운로드 (Direct Download): [최신 릴리스 (Latest Release)]
Agent Orchestrator는 신뢰성 및 제품 이해를 위해 최소한의 텔레메트리 (telemetry)를 수집합니다. 데이터는 기본적으로 로컬에 저장되며, 원격 전송은 환경 변수를 통해 선택적으로 참여 (opt-in)할 수 있습니다. 전체 텔레메트리 정책을 읽어보세요.
Agent Orchestrator는 교체 가능한 어댑터 (adapters)를 갖춘 **인바운드/아웃바운드 포트 계약 (inbound/outbound port contracts)**을 중심으로 구축된 장기 실행 Go 데몬 (daemon)입니다.
핵심 멘탈 모델 (Core mental model): 외부 사실 관찰 (OBSERVE) → 영구적 사실 업데이트 (UPDATE) → 표시 상태 도출 (DERIVE display status) / 실행 (ACT)
주요 구성 요소:
프론트엔드 (Frontend)- TanStack Router/Query 및 shadcn/ui를 사용하는 Electron + React UI
백엔드 데몬 (Backend Daemon)- 컨트롤러 (controllers), 서비스 (services), 어댑터 (adapters)를 갖춘 Go 기반 HTTP 서버
런타임 (Runtime)- 플랫폼별:
- Darwin/Linux의 경우
tmux - Windows의 경우
conpty
스토리지 (Storage)- 실시간 업데이트를 위한 변경 데이터 캡처 (CDC) 기능이 포함된 SQLite
어댑터 (Adapters)- 23개 이상의 에이전트 어댑터 (agent adapters), git worktree 워크스페이스, GitHub SCM 통합
상세한 아키텍처 다이어그램 (architecture diagrams), 데이터 흐름 (data flows), 그리고 부하 지지 규칙 (load-bearing rules)은 architecture.md를 참조하세요.
| 문서 | 설명 |
|---|---|
| Architecture | 시스템 아키텍처, 데이터 흐름 및 부하 지지 규칙 |
| ... |
# 백엔드 테스트 (Backend tests)
cd backend
go test -race ./...
...
모든 설정은 환경 기반 (environment-driven)입니다. 데몬은 별도의 설정 파일을 사용하지 않습니다.
| 변수 (Variable) | 기본값 (Default) | 용도 (Purpose) |
|---|---|---|
AO_PORT | 3001 | HTTP 바인드 포트 (HTTP bind port) |
AO_REQUEST_TIMEOUT | 60s | 요청당 타임아웃 (Per-request timeout) |
AO_SHUTDOWN_TIMEOUT | 10s | 우아한 종료 제한 (Graceful shutdown cap) |
AO_RUN_FILE | ~/.ao/running.json | PID/포트 핸드셰이크 (PID/port handshake) |
AO_DATA_DIR | ~/.ao/data | SQLite 데이터 디렉토리 |
AO_AGENT | claude-code | 호환성 에이전트 어댑터 |
GITHUB_TOKEN | - | GitHub 인증 토큰 |
curl localhost:3001/healthz # Liveness probe (생존 확인 프로브)
curl localhost:3001/readyz # Readiness probe (준비 상태 프로브)
우리는 기여를 환영합니다! 시작하려면 Discord에서 저희 커뮤니티에 참여하세요.
일일 기여자 싱크 (Daily contributor sync): 매일 오후 10:00 IST
코어 기여자(core contributors)로부터 이슈를 검증받고, 질문을 던지며, 진행 상황을 공유하고, 커뮤니티로부터 배우세요. 새로운 기여자는 언제나 환영합니다!
Discord에 참여해야 하는 이유:
- 시간을 투자하기 전에 코어 기여자(core contributors)로부터 이슈와 PR(Pull Request)을 검증받을 수 있습니다.
- 일일 싱크(daily sync) 콜에서 숙련된 기여자들로부터 배울 수 있습니다.
- 진행 상황을 공유하고 피드백을 받을 수 있습니다.
- 실시간으로 문제 해결(troubleshooting)에 대한 도움을 받을 수 있습니다.
- 최신 개발 사항과 로드맵(roadmap)에 대한 정보를 계속 접할 수 있습니다.
Discord 참여하기- 커뮤니티와 연결하고 가이드를 받으세요
기여자 계약(contributor contract) 읽기- 리포지토리 레이아웃, 데몬(daemon)/API 경계, 코딩 컨벤션(coding conventions)은 AGENTS.md를 참조하세요
집중할 문제 선택하기- 오픈 이슈(open issues)를 살펴보고 집중적인 PR을 보낼 수 있을 만큼 작은 문제를 선택하세요
명확한 PR 생성하기- 변경 사항을 좁게 유지하고, 사용자에게 보이는 영향(user-visible impact)을 설명하며, 이슈를 연결하고, 테스트를 포함하세요
기여자와 함께 반복(iterate)하기- 검증될 때까지 리뷰 피드백을 사용하여 PR을 다듬으세요
Apache License 2.0 - 자세한 내용은 LICENSE를 참조하세요.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Trending Go (weekly)의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기