GitHub요약2026. 11. 13. 09:38

awslabs/cli-agent-orchestrator 대표 이미지

awslabs/cli-agent-orchestrator

원문 발행 2026. 11. 13. 08:03원문 언어 영어AI 한국어 번역GitHub Codex tools 원문 보기

요약

CLI Agent Orchestrator (CAO)는 여러 AI 코딩 CLI를 조정하는 오케스트레이터입니다. 이 도구는 슈퍼바이저 역할을 수행하여 전문 에이전트들에게 작업을 병렬 또는 순차적으로 위임할 수 있게 합니다. CAO는 로컬 서버와 슈퍼바이저 기능을 통해 각 에이전트를 격리된 터미널 세션에서 관리합니다.

핵심 포인트

CAO는 여러 AI 코딩 CLI를 조정하는 오케스트레이터입니다.
슈퍼바이저는 작업을 전문 에이전트에게 병렬 또는 순차적으로 위임합니다.
로컬 cao-server와 격리된 터미널 세션을 사용하여 에이전트를 관리합니다.
사용을 위해 Python 3.11+, tmux, uv 등의 전제 조건이 필요합니다.

AI 자동 생성 콘텐츠

본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기

0

댓글

0

<p align="center"> <img src="https://raw.githubusercontent.com/awslabs/cli-agent-orchestrator/main/docusaurus/static/img/cao-social-card.png" alt="" width="640"> </p>

CLI Agent Orchestrator (CAO)

English | 简体中文

PyPI version

Python versions

Python versions

**CLI Agent Orchestrator (CAO)**는 여러 AI 코딩 CLI를 조정하여, 슈퍼바이저가 전문 에이전트들에게 작업을 병렬 또는 순차적으로 위임할 수 있도록 합니다.

📚 Documentation — 가이드, 참고 자료 및 두 개의 인터랙티브 코스.

CAO가 하는 일

CAO는 로컬 cao-server를 실행하고, 제공자(provider) CLI들을 격리된 터미널 세션에서 시작하며, 워커들을 조정하기 위한 슈퍼바이저 도구를 제공합니다. 에이전트들은 자체 인증 및 기능을 가진 완전한 CLI 프로세스로 남아 있습니다. 런타임 아키텍처와 패키지 레이아웃은 CODEBASE.md를 참조하십시오.

전제 조건

설치:

파이썬(Python) 3.11 이상
tmux 3.3 이상
uv
CAO를 실행하기 전에 인증된 지원 프로바이더(provider) CLI가 최소 하나 필요합니다:
Kiro CLI, Claude Code,
Codex CLI, Antigravity CLI,
Hermes, Kimi CLI,
MiniMax Code,
GitHub Copilot CLI,
OpenCode CLI, Oh My Pi(OMP) CLI,
Cursor CLI, 또는
Grok Build CLI

개별 프로바이더 가이드에는 설치, 인증 및 해당 프로바이더별 동작 방식이 포함되어 있습니다.

CAO 설치

현재 main 브랜치를 uv 도구로 설치합니다:

uv tool install git+https://github.com/awslabs/cli-agent-orchestrator.git@main --upgrade
cao --help

태그가 지정된 릴리스의 경우, PyPI에서 cli-agent-orchestrator를 설치합니다.
소스 체크아웃(source checkout)에 대한 내용은 DEVELOPMENT.md를 참조하십시오.
컨테이너 기반 설치의 경우, devcontainer 기능을 참조하십시오.

기존 CAO 설치를 업데이트하려면:

cao update

소스 인식 동작(source-aware behavior) 및 엣지 케이스(edge cases)에 대한 내용은 CAO 업데이트를 참조하십시오.

첫 번째 슈퍼바이저 실행

아래의 비지정 명령어들은 CAO의 기본 Kiro CLI 프로바이더를 사용합니다. 다른 프로바이더를 설치한 경우, 동일한 순서를 유지하면서 해당 프로바이더의 개별 가이드를 따라 프로바이더를 재정의(override)하십시오.

내장 슈퍼바이저 프로필을 설치합니다:

cao install code_supervisor


2. 터미널 A에서 로컬 서버를 시작하고 실행 상태로 유지합니다:

```bash
cao-server

터미널 B에서 에이전트가 작업해야 하는 프로젝트 디렉터리로 이동한 다음 슈퍼바이저를 실행합니다:

cd /path/to/your/project
cao launch --agents code_supervisor


4. 첨부된 실행 터미널에서 슈퍼바이저(supervisor)를 관찰하고, `http://localhost:9889`의 [Web UI](docs/web-ui.md)를 열거나, [tmux 가이드](docs/tmux.md)를 따라 세션에 연결합니다.

5. 작업 완료 시 이름 지정된 세션을 중지합니다:

```bash
cao shutdown --session {session-name}

대신 모든 CAO 세션을 중지하려면 cao shutdown --all을 실행합니다.

다음 탐색할 주제

CAO 운영하기

Control-plane selection: Web UI, 셸(shell) CLI, operations MCP 서버 또는 플러그인을 선택합니다.
Web UI 및 MCP Apps: 브라우저 기반 및 호스트 렌더링된 플릿 인터페이스입니다.
Flows 및 workflows: 스케줄링 실행(scheduled runs) 및 다단계 파이프라인입니다.
Launch decisions: 로컬 라우팅 설정 및 콘텐츠가 없는 기록을 관리합니다.
Skills: 재사용 가능한 에이전트 가이던스(agent guidance)를 설치, 범위 지정(scope), 작성합니다.
Skills lifecycle example: 격리된 환경에서 재사용 가능한 스킬을 설치, 검색, 로드, 적용, 업데이트 및 제거하는 방법을 보여줍니다.
Memory 및 self-learning: 영구적인 크로스 세션 메모리(cross-session memory)와 워크플로우 결과를 교훈 및 승격된 지침으로 변환하는 옵트인 루프입니다.
AI-DLC portfolio example: 저장소 및 격리된 작업 트리 전반에 걸쳐 병렬 AI-DLC 인텐트(intent)를 조정합니다.
Cross-zone robot transport: 시뮬레이션된 운송, 측정된 관리 인계(custody handoffs), 독립적인 점검을 조정합니다.
Hierarchical robot factory: 슈퍼바이저와 세 명의 팀 매니저 에이전트가 시뮬레이션된 제작, 조립 및 선적 라인에서 아홉 개의 Open Duck Mini 로봇을 운영하며 병목 현상을 균형 있게 조정합니다.
Self-hosted decision model: 오픈 JevK5-4B 결정 모델(decision model)을 로컬 또는 AWS (CDK)에서 실행하며, 루프백 전용 /v1/systemone API 뒤에 배치합니다.
도구 제한: 역할(roles), 허용 목록(allowlists) 및 제공업체 강제 적용(provider enforcement).
Kubernetes 배포: 공유 작업 공간, 파드별 상태(per-pod state), 자격 증명 전달 기능을 갖춘 Amazon EKS에서 감독자(supervisor)와 워커 플릿을 실행하는 방법.
CAO 업데이트: 설치된 uv 도구 업데이트하기.

구성 및 통합 (Configure and integrate)

임시 에이전트: 다른 에이전트가 생성하고 실행하는 옵트인(opt-in), 일회용 보조 에이전트와 그 제한 사항.
임시 에이전트 설정 매뉴얼: 에이전트가 따라 할 수 있도록 작성된 임시 에이전트 및 결정자(decider)의 단계별 설정 가이드.
에이전트 프로필: 프로필 스키마, 검색(discovery), 제공업체 선택, 재정의(overrides).
HTTP API 및 PTY WebSocket: 라우팅 계열 개요와 터미널 스트리밍 계약(terminal streaming contract).
에이전트 플러그인: 휴대용 Agent Plugins 1.0.0 패키지, 그리고 CAO 자체 오퍼레이터 및 기여자 패키지를 설치하는 방법. CLI, TUI(Text User Interface), 웹 패널, 그리고 /plugins* HTTP 라우트 등 모든 표면은 명명 결정이 내려질 때까지 기본적으로 차단되어 있습니다(gated off by default). CAO_AGENT_PLUGINS_ENABLED를 설정하여 활성화할 수 있으며, 그 전까지는 등록되지 않은 경로와 마찬가지로 해당 라우트는 404 응답을 반환합니다.
이벤트 플러그인: 아웃바운드 이벤트(outbound events), 설치 및 작성 방법.
제공업체 동작 방식:
Kiro CLI, Claude Code, Codex CLI, Antigravity CLI, Hermes, Kimi CLI, MiniMax Code,
GitHub Copilot CLI, OpenCode CLI, Oh My Pi(OMP) CLI,
Cursor CLI, 그리고
Grok Build CLI.
보안 정책: 취약점 보고 및 배포 가이드라인.

기여 (Contribute)

코드베이스 가이드: 런타임 표면(runtime surfaces), 패키지 소유권(package ownership), 및 데이터 흐름(data flow).
개발 가이드: 로컬 설정(local setup), 테스트(testing), 및 검증(verification).
릴리스 가이드: 유지 관리자 릴리스 프로세스(maintainer release process).

기여 (Contributing)

변경 사항을 제출하기 전에 CONTRIBUTING.md와 DEVELOPMENT.md를 참조하세요. 문서 변경 사항은 또한 문서 유지 관리 규칙(documentation maintenance rule)을 따라야 합니다.

라이선스 (License)

이 프로젝트는 Apache License 2.0에 따라 라이선스가 부여됩니다. LICENSE를 참조하세요.