Skip to content

Latest commit

 

History

History
210 lines (152 loc) · 20.8 KB

README.ko.md

File metadata and controls

210 lines (152 loc) · 20.8 KB
Orchestrator.inc logo

Orchestrator.inc

에이전트를 일일이 돌보지 마세요. 실제 작업을 머지하세요.

브랜치, 리뷰, CI 실패를 관리 가능한 상태로 유지하면서 여러 코딩 에이전트를 함께 실행하세요.

GitHub stars GitHub release GitHub downloads License: Apache-2.0 X Discord


Orchestrator.inc 받기  •  문서  •  릴리스  •  기여하기  •  Discord

English · 简体中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português (Brasil)


워커 세션을 실시간 상태별로 보여주는 Orchestrator.inc Kanban

왜 Orchestrator.inc인가

코딩 에이전트 하나는 작업 하나를 처리할 수 있습니다. 여러 에이전트를 실행하려면 작업을 나누고, 브랜치 충돌을 막고, 모든 변경 사항을 CI, 리뷰, 머지까지 추적해야 합니다. Orchestrator.inc는 이를 위한 로컬 데스크톱 워크스페이스입니다. 모든 작업은 전용 에이전트, 브랜치, worktree를 가지며, 코드는 내 컴퓨터를 벗어나지 않습니다.

기능

오케스트레이터가 에이전트 전체를 운영합니다

프로젝트의 메인 에이전트에게 무엇을 만들고 싶은지 알려주세요. 오케스트레이터가 작업을 계획하고, 각 부분마다 별도 worktree에서 워커를 시작하며, 사용자가 필요할 때만 돌아옵니다.

결제 기능을 세 개의 워커로 나누는 오케스트레이터. 각 워커는 별도 worktree에서 서로 다른 코딩 에이전트로 실행됩니다

모든 세션을 하나의 보드에서

세션은 에이전트, PR, CI, 리뷰 상태에 따라 레인으로 자동 정렬되므로 사용자의 확인이 필요한 항목이 항상 맨 위에 표시됩니다.

Working, Needs you, In review, Ready to merge 레인이 있는 Kanban 보드

CI가 실패하면 담당 에이전트가 고칩니다

실패한 검사, 리뷰 코멘트, 머지 충돌은 PR이 승인될 때까지 해당 브랜치를 맡은 워커에게 돌아갑니다. 사람이 보기 전에 리뷰어 에이전트가 모든 PR을 먼저 검토할 수도 있습니다.

실패한 검사와 리뷰 코멘트가 Claude Code로 전달되고, Claude Code가 수정 사항을 푸시하는 풀 리퀘스트 타임라인

이미 신뢰하는 에이전트를 그대로 사용하세요

작업마다 에이전트와 모델을 선택한 뒤 구조화된 Chat 또는 에이전트 고유의 터미널 UI에서 작업하세요. 각 워커에는 앱을 미리 보고 테스트할 수 있는 브라우저도 제공됩니다.

지원 에이전트

워커, Chat, 리뷰어 지원 여부는 에이전트마다 다릅니다. 최신 지원 현황은 에이전트 설정 가이드를 확인하세요.

Claude Code   Claude Code Codex   Codex Cursor   Cursor
opencode   opencode Aider   Aider GitHub Copilot   GitHub Copilot
Grok   Grok Kimi   Kimi Pi   Pi
Amp   Amp Auggie   Auggie Droid   Droid
Crush   Crush Cline   Cline Goose   Goose
Qwen   Qwen Continue   Continue Devin   Devin
Kiro   Kiro Kilo Code   Kilo Code Vibe   Vibe
Muse   Muse Agy   Agy Autohand Autohand
Kimchi   Kimchi Prime Agent   Prime Agent OMP   OMP
fx   fx Unreal Agent   Unreal Agent MiMo Code   MiMo Code
Gemini CLI   Gemini CLI DeepSeek   DeepSeek OpenCode 2   OpenCode 2
Codewhale   Codewhale Command Code   Command Code OpenHands   OpenHands

Orchestrator for Mobile

데스크톱에서 실행 중인 에이전트를 휴대폰으로 제어하세요. iPhone 또는 Android용 앱을 설치하세요. Settings → Connect Mobile의 QR 코드를 스캔해 데스크톱과 페어링하세요. 집 Wi-Fi에서도, 외부에서도 작동합니다.

  • 알림 받기. 에이전트에게 질문이 있거나 승인이 필요하면 푸시 알림이 옵니다.
  • 답하기. 채팅으로 답하거나, 요청을 승인하거나, 에이전트의 터미널을 여세요.
  • 작업 시작. 새 워커를 만들고 에이전트와 모델을 고르세요.
  • 리뷰. 풀 리퀘스트와 리뷰어 결과를 확인하세요.

어떤 메일 제공업체를 사용할지 묻는 에이전트와 휴대폰에서 보낸 답장을 보여주는 모바일 앱

Cloud Agents

워커를 내 컴퓨터가 아닌 호스팅된 작업 공간에서 실행하세요. Clone to the cloud를 선택하고 GitHub 저장소를 고르면 시작됩니다.

  • 계속 실행. 노트북을 덮어도 작업이 계속됩니다.
  • 진행 상황 확인. 데스크톱 앱에서 채팅, 파일, 터미널을 여세요.
  • 내 컴퓨터에는 아무것도 없음. 코드, 워크트리, 에이전트가 모두 클라우드에 있습니다.

설정 방법은 Cloud 가이드를 참고하세요.

설치

orchestrator.inc/download 또는 GitHub Releases에서 다운로드하세요. 앱은 자동으로 업데이트됩니다.

플랫폼 다운로드
macOS (Apple silicon) agent-orchestrator-darwin-arm64.dmg
macOS (Intel) agent-orchestrator-darwin-x64.dmg
Windows agent-orchestrator-win32-x64.exe
Linux (AppImage) agent-orchestrator-linux-x64.AppImage
Linux (Debian/Ubuntu) agent-orchestrator-linux-x64.deb
Linux (Fedora/RHEL) agent-orchestrator-linux-x64.rpm

Orchestrator.inc를 열고 관리할 저장소를 지정하세요. 데스크톱 앱이 데몬을 실행하므로 CLI는 필요하지 않습니다. 에이전트 CLI 설정 및 문제 해결은 설치 가이드를 참고하세요.

문서

문서 다음 정보가 필요할 때
제품 문서 설치, 에이전트 설정, 일상적인 제품 사용법.
docs/documentation-map.md 어떤 문서가 사람을 위한 것이고 어떤 문서가 기계 판독용 계약인지, 내용이 어긋날 때 어느 쪽이 우선하는지.
docs/architecture.md 백엔드 멘탈 모델, 라이프사이클, 영속성, CDC, 상태 도출, 데몬 경계.
docs/backend-code-structure.md 패키지 소유권과 각 백엔드 관심사가 속하는 위치.
docs/cli/README.md CLI 동작과 데몬 라우트 매핑.
docs/development.md 로컬 개발을 위한 사전 요구 사항, 빌드 단계, 테스트 실행, 문제 해결.
docs/STATUS.md 현재 main에 출시된 내용과 아직 진행 중인 항목.

기여하기

사전 요구 사항, 로컬 설정, 테스트 명령은 개발 가이드부터 확인하세요. 풀 리퀘스트를 열기 전에 CONTRIBUTING.md를 읽고, 버그와 기능 요청에는 GitHub Issues를 사용하세요.

버그 신고

본인의 GitHub 계정으로 버그 신고를 여세요. 무엇을 했고 어떤 문제가 발생했는지 몇 문장이면 충분합니다. 버전, 운영체제, 재현 단계가 있다면 도움이 됩니다.

로컬 코딩 에이전트는 bug-triage skill로 증거 수집을 도울 수 있습니다. 에이전트의 로그와 메모는 첨부 파일로 제공하고, 직접 제출하기 전에 초안을 검토하세요. 봇에게 대신 이슈를 등록하게 하지 마세요.

문제 설명에 도움이 필요하면 Discord bug-triaging 채널에 참여하세요. 자세한 내용은 기여 가이드를 참고하세요.

커뮤니티

도움 및 기여자 논의를 위해 Discord에 참여하고, 업데이트를 보려면 @useOrchestrator를 팔로우하세요. GitHub Issues에서 대화를 시작할 수도 있습니다.

Star 기록

OrchestratorInc/agent-orchestrator의 Star 기록 차트

제품 텔레메트리

Orchestrator.inc는 제한된 사용 및 안정성 텔레메트리를 수집하며, 코드, 프롬프트, 에이전트 대화, 자격 증명은 절대 수집하지 않습니다. 여기에는 설치 ID와 GitHub 사용자 이름이 포함됩니다. AO Cloud에 로그인하면 AO Cloud 사용자 ID와 해당 계정의 이메일 주소도 포함되며, 이는 PostHog person 속성으로 한 번 설정됩니다(git config에서 읽지 않음). Settings > General > Privacy > Share usage analytics에서 모두 끌 수 있으며, 이 설정은 데스크톱, 데몬, 페어링된 휴대폰에 모두 적용됩니다. 수집 항목과 옵트아웃 방법 자세히 보기.

라이선스

Orchestrator.inc는 Apache License 2.0에 따라 제공됩니다.