Mozzie

Mozzie란?

Mozzie는 AI 코딩 에이전트를 관리된 인력처럼 오케스트레이션하는 로컬 우선 데스크톱 앱입니다. 한 번에 단일 에이전트 세션만 실행하는 대신, 만들고 싶은 것을 설명하면 Mozzie가 작업을 아이템으로 나누고, 여러 에이전트를 병렬로 실행하며, git 기반 워크플로로 출력을 조정합니다.

앱은 작업과 오케스트레이션을 기기에 유지하도록 설계되었습니다. 작업 아이템당 격리된 git worktree를 생성하고, 아이템 간 의존성을 관리하며, 병합 전에 변경을 승인하거나 거부할 수 있는 리뷰 흐름을 제공합니다.

주요 기능

• 오프라인 워크플로와 로컬 우선 실행: 로컬 SQLite 데이터베이스를 사용하며, 에이전트 실행 워크플로를 포함해 모든 것을 기기에서 실행합니다.
• 자연어 요청을 작업 아이템으로 오케스트레이션: 오케스트레이터가 요청을 작업 아이템으로 변환하고, 실행 순서를 설정하며, 에이전트를 할당합니다.
• 병렬 멀티 에이전트 지원: Claude Code, Gemini CLI, Codex CLI, 사용자 지정 CLI/스크립트 등을 포함해 여러 코딩 에이전트를 동시에 실행합니다.
• 작업 아이템당 git worktree 격리: 각 작업 아이템이 독립된 worktree와 브랜치에서 실행되어 에이전트 실행 간 충돌을 줄입니다.
• 리뷰 + 병합 워크플로: 에이전트 완료 후 Mozzie가 diff/리뷰 단계를 제공합니다. 승인 시 origin으로 푸시하고, 거부 시 다음 시도에 피드백을 제공합니다.
• 의존성 그래프와 차단 아이템 자동 실행: 작업 아이템이 서로 의존할 수 있으며, 의존성이 완료되면 차단된 아이템이 자동 실행되고, 순환 감지가 포함됩니다.
• 서브 작업 아이템(스택 브랜치) 및 부모/자식 병합: 자식 브랜치가 부모 작업 아이템으로 병합되며, 부모가 하나의 PR로 origin에 푸시합니다.
• 세션 간 지속적 대화: 오케스트레이터 컨텍스트가 유지되어 중단한 곳부터 이어서 진행할 수 있습니다.
• 에이전트 출력 실시간 스트리밍: 도구 호출 활동 시각화를 포함해 에이전트 출력을 실시간으로 확인할 수 있습니다.

Mozzie 사용 방법

1. 필수 구성 요소 설치: Node >= 20, pnpm >= 9, Rust (stable), 플랫폼별 Tauri 필수 구성 요소를 사용합니다. 최소 하나의 AI 코딩 에이전트 CLI가 설치되어 있는지 확인하세요.
2. 앱 설정:
   • 저장소를 클론하고 의존성을 설치합니다 (pnpm install).
   • 개발 앱을 시작합니다 (pnpm dev). 앱이 열립니다.
3. 프로바이더 및 에이전트 구성:
   • 설정 열기 (기어 아이콘)에서 LLM 오케스트레이터 프로바이더(OpenAI, Anthropic, Gemini)의 API 키를 추가합니다.
   • 실행할 코딩 에이전트(예: Claude Code, Gemini CLI, Codex, 사용자 지정)에 대한 에이전트 구성을 추가합니다.
4. 작업 아이템 생성 및 실행:
   • 작업 아이템을 생성하고, repo를 지정하며, 에이전트를 할당한 후 실행을 시작합니다.
   • 또는 명령 바(Ctrl+K)를 열고 만들고 싶은 것을 설명하면, 오케스트레이터가 작업 아이템을 생성하고 큐에 추가합니다.
5. 리뷰 및 병합:
   • 작업 아이템이 리뷰 단계에 도달하면 변경을 origin으로 푸시하도록 승인합니다.
   • 거부 시 피드백을 제공하세요. Mozzie는 전체 시도 기록과 거부 이유를 다음 에이전트 프롬프트에 포함합니다.

사용 사례

• 기능 요청을 여러 병렬 코딩 작업으로 분할: 명령 바를 통해 큰 변경을 설명하면 Mozzie가 작업 아이템으로 나누고, 지원 에이전트를 병렬 실행해 리뷰 가능한 브랜치를 생성합니다.
• 에이전트 출력을 격리하며 repo 작업: 여러 접근 방식을 실험할 때, 각 작업 아이템이 독립된 git worktree와 브랜치에서 실행되어 에이전트 실행이 서로 간섭하지 않습니다.
• 다단계 의존성 처리(예: 스캐폴딩 후 구현): 의존성을 가진 작업 아이템을 생성하면, 전제 아이템 완료 후 차단된 아이템이 자동 실행되며, 순환 계획을 방지하는 순환 감지가 포함됩니다.
• 실패 시도 후 구조화된 피드백으로 반복: 리뷰 중 작업 아이템을 거부하고 피드백을 포함하세요. Mozzie는 전체 시도 기록(거부 이유 포함)을 다음 실행에 주입해 같은 실수를 반복하지 않습니다.
• 하나의 데스크톱 앱 세션에서 여러 프로젝트 관리: 멀티 워크스페이스 지원을 사용해 동일 앱 내 여러 repo의 작업 아이템을 실행하고 리뷰합니다.

자주 묻는 질문

• Mozzie 실행에 클라우드 연결이 필요하나요? Mozzie는 로컬 우선이며 완전 오프라인으로 작동한다고 설명되어 있습니다.

• 어떤 AI 코딩 에이전트를 실행할 수 있나요? 저장소에 Claude Code (ACP/stdio 전송 사용), Gemini CLI, Codex CLI, 사용자 지정 CLI/스크립트에 대한 기본 지원이 나열되어 있습니다.

• Mozzie가 에이전트 간 충돌을 어떻게 방지하나요? 작업 항목당 격리된 git worktree와 브랜치를 생성하므로 동시 실행이 동일한 작업 디렉터리를 공유하지 않습니다.

• 리뷰 중 작업 항목을 거부하면 어떻게 되나요? Mozzie는 전체 시도 기록과 거부 이유를 에이전트의 다음 프롬프트에 포함하며, 상태가 리뷰에서 재실행 경로로 되돌아갈 수 있습니다.

• 작업 항목이 서로 의존할 수 있나요? 네. Mozzie는 의존성 그래프를 지원하며, 의존성이 완료되면 차단된 항목을 자동 실행하고 순환 감지를 포함합니다.

대안

• 단일 에이전트 IDE 도구 또는 채팅 기반 코딩 어시스턴트: 한 번에 하나의 에이전트 세션을 원할 때 유용; 일반적으로 작업 항목 의존성 오케스트레이션과 git worktree 격리를 제공하지 않습니다.
• 여러 작업을 CLI에 분배하는 로컬 스크립트 러너: 에이전트 명령을 병렬화할 수 있지만, 오케스트레이션, 의존성 관리, 리뷰 워크플로를 직접 구축해야 합니다.
• 코드 생성 및 PR 리뷰를 위한 CI/CD 기반 자동화: 리뷰 게이트와 브랜칭을 처리할 수 있지만, 대화형 로컬 "한 창" 오케스트레이션 워크플로에 덜 적합합니다.
• 로컬 우선 git worktree가 없는 AI 에이전트 워크플로/오케스트레이션 도구: 에이전트 호출을 조정할 수 있지만, Mozzie에 설명된 특정 git worktree 격리와 스택 브랜치 병합 워크플로를 제공하지 않을 수 있습니다.