RunMaestro/Maestro
Agent Orchestration Command Center
Maestro – 여러 AI 코딩 에이전트를 관리하는 데스크톱 허브
무엇인가요 – Maestro는 키보드 중심 인터페이스를 통해 수십 개의 AI 기반 코딩 어시스턴트(Claude Code, OpenAI Codex, OpenCode, Factory Droid, Copilot-CLI 등)를 실행, 정리, 자동화할 수 있는 크로스플랫폼 데스크톱 앱입니다. 각 에이전트는 독립된 '세션'으로 간주되며, 자체 파일 시스템 뷰, 셸, 대화 기록을 가지며, 동시에 실행, 체인 연결, 비용 및 출력 추적 기능도 제공합니다.
왜 중요한가요 – 현대 개발자는 동시에 여러 AI 코드 생성 서비스를 사용하는 경우가 많습니다. CLI, 브라우저 탭, IDE 플러그인 간 전환은 빠르게 혼란스러워집니다. Maestro는 인증, 파일 접근, 채팅을 통합하고, 강력한 자동화(플레이북), Git 인식 병렬 처리를 제공하여 에이전트가 서로 다른 브랜치에서 작업해도 충돌 없이 작업할 수 있도록 합니다.
핵심 기능 (README에 설명됨)
| 카테고리 | 기능 |
|---|---|
| 다중 에이전트 오케스트레이션 | 무제한의 에이전트를 병렬로 실행할 수 있으며, 각 에이전트는 자체 AI 터미널과 셸 터미널을 갖습니다. 그룹 채팅을 통해 매개 AI가 질문을 라우팅하고 에이전트 간 답변을 통합할 수 있습니다. |
| 병렬 개발 | Git Worktrees 통합으로 각 에이전트용 고립된 브랜치 워크스페이스를 생성하여 진정한 병렬 코딩과 한 번의 클릭으로 PR 생성이 가능합니다. |
| 자동화 | 자동 실행 및 플레이북 – 파일 시스템 기반 작업 실행기로, 마크다운 체크리스트를 실행하며, 각 작업마다 새 AI 세션을 생성하고 전체 기록을 보존합니다. |
| 원격 제어 | 내장 웹 서버와 QR 코드 접근; 로컬 네트워크 또는 Cloudflare 터널을 통한 스마트폰 또는 다른 장치에서 원격 접근 가능. |
| CLI | maestro-cli로 헤드리스 운영 가능, cron 작업이나 CI 파이프라인에 적합. 인간이 읽을 수 있는 형식 또는 JSONL로 출력하여 스크립팅에 활용 가능. |
| 내구성 | 제공자 오류(예: 529 과부하) 시 자동 재시도, 백업 엔드포인트로의 선택적 장애 대체, 에이전트가 바쁠 때 메시지 큐잉. |
| 키보드 우선 UI | 사용자 정의 단축키, 마스터리 추적, 빠른 작업 팔레트(Cmd/Ctrl+K), 즉시 에이전트 전환(Cmd/Ctrl+J). |
| 파일 탐색기 및 뷰어 | 구문 강조 표시, 마크다운 미리보기, Mermaid 렌더링, JSON/CSV/Parquet 전용 뷰어 및 실시간 필터링. |
| 분석 및 시각화 | 사용량 대시보드(토큰/비용 통계, 히트맵) 및 마크다운 파일 간 위키 스타일 링크를 매핑하는 문서 그래프. |
| 비용 및 토큰 추적 | 세션별 및 전역 실시간 토큰 사용량과 비용 추정. |
| 게임화된 진행 상황 | 누적 자동 실행 시간에 따라 성취 및 랭크(초보자 → 타이탄) 제공. |
| 테마 | 12개의 내장 색상 테마(Dracula, Nord, Tokyo Night 등). |
일반적인 워크플로우
- AI 제공자 추가 – Claude Code, Codex, OpenCode 등을 인증(마스터는 이미 있는 자격 증명을 그대로 전달).
- 워크트리 생성 – Git 브랜치 선택; Maestro가 하위 에이전트를 생성하여 자체 디렉터리에서 작업.
- 플레이북 작성 – 작업의 마크다운 체크리스트(예: "API 클라이언트 생성 → 테스트 실행 → PR 열기").
- 자동 실행 실행 – Maestro가 각 단계를 새 AI 세션에서 시작하고, 메시지를 큐에 넣으며 전체 대화 기록을 기록.
- 모니터링 – 사용량 대시보드 또는 원격 웹 UI(스마트폰에서)를 통해 진행 상황 확인.
- 반복 – 그룹 채팅을 사용해 고수준 설계 질문을 던지고, 매개 AI가 개별 코딩 에이전트의 응답을 조율하도록 함.
시작하기 (README에서)
# 개발 버전을 클론하고 실행
git clone https://github.com/RunMaestro/Maestro.git
cd Maestro
npm install
npm run dev
또는 Releases 페이지에서 사전 빌드된 바이너리를 다운로드하세요.
사전 요구 사항 – 최소 하나 이상의 지원되는 AI 코딩 에이전트 설치 및 인증(Claude Code, OpenAI Codex, OpenCode, Copilot-CLI) 및 워크트리 기능을 사용하려면 Git 필요.
Maestro를 사용해야 할 사람
- 대부분의 시간을 키보드 중심으로 사용하고, 마우스 최소화가 필요한 파워 유저.
- 여러 AI 지원 코드 생성 도구를 병렬로 사용하는 개발자(예: Claude Code와 Codex의 출력 비교).
- 일상적인 AI 기반 작업(스켈레톤 생성, 리팩터링, PR 생성)에 공유되고 재현 가능한 자동화 계층(플레이북)을 원하는 팀.
- 여러 제공자 간 토큰 사용량과 비용을 한 곳에서 모니터링하고 싶은 사람.
라이선스 및 커뮤니티
- 라이선스: AGPL-3.0 (네트워크로 배포되는 수정 사항은 소스 공개가 필수).
- 지원: Discord 커뮤니티, GitHub Issues, https://docs.runmaestro.ai 에 풍부한 문서 제공.
결론
Maestro는 새로운 AI 모델이 아닙니다. 기존 코딩 어시스턴트를 조율된 팀처럼 작동시키는 오케스트레이션 계층입니다. Git 워크트리, 자동 플레이북, 풍부한 키보드 기반 UI, 내구성 기능을 결합하여, AI 보조 개발을 일시적인 프롬프트의 연속에서 반복 가능하고 관찰 가능한 워크플로우로 전환하는 것을 목표로 합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트