Mozzie

O que é Mozzie?

Mozzie é um app desktop local-first que orquestra agentes de IA de codificação como uma força de trabalho gerenciada. Em vez de executar uma sessão de agente por vez, você descreve o que quer construir e o Mozzie divide o trabalho em itens, executa múltiplos agentes em paralelo e coordena a saída deles por meio de um fluxo de trabalho baseado em git.

O app é projetado para manter o trabalho e a orquestração na sua máquina. Ele cria git worktrees isolados por item de trabalho, gerencia dependências entre itens e oferece um fluxo de revisão para que você aprove ou rejeite mudanças antes de fazer o merge.

Principais Recursos

• Execução local-first com fluxo offline: Usa um banco SQLite local e executa tudo na sua máquina, incluindo o fluxo de execução dos agentes.
• Orquestração em linguagem natural em itens de trabalho: O orquestrador converte sua solicitação em itens de trabalho, define a ordem de execução e atribui agentes.
• Suporte a múltiplos agentes em paralelo: Executa vários agentes de codificação simultaneamente, com suporte nativo a Claude Code, Gemini CLI, Codex CLI e CLIs/scripts personalizados.
• Isolamento via git worktree por item de trabalho: Cada item de trabalho é executado em seu próprio worktree e branch, reduzindo conflitos entre execuções de agentes.
• Fluxo de revisão + merge: Após o agente concluir, o Mozzie oferece uma etapa de diff/revisão; aprovar envia para origin, rejeitar alimenta feedback na próxima tentativa.
• Grafo de dependências com auto-lançamento de itens bloqueados: Itens de trabalho podem depender uns dos outros; itens bloqueados iniciam automaticamente quando dependências concluem, com detecção de ciclos.
• Sub-itens de trabalho (branches empilhados) e merge pai/filho: Branches filhos fazem merge em um item pai; o pai envia para origin como um único PR.
• Conversas persistentes entre sessões: O contexto do orquestrador é preservado para você retomar de onde parou.
• Streaming ao vivo da saída do agente: Você pode acompanhar a saída do agente em tempo real, incluindo visualização de atividade de tool-call.

Como Usar o Mozzie

1. Instale os pré-requisitos: Use Node >= 20, pnpm >= 9, Rust (stable) e os pré-requisitos Tauri específicos da plataforma. Certifique-se de ter pelo menos um CLI de agente de IA de codificação instalado.
2. Configure o app:
   • Clone o repositório e instale dependências (pnpm install).
   • Inicie o app de desenvolvimento (pnpm dev). O app abrirá.
3. Configure provedores e agentes:
   • Em Abrir Configurações (ícone de engrenagem), adicione chaves de API para o provedor do orquestrador LLM (OpenAI, Anthropic ou Gemini).
   • Adicione configurações de agentes para os agentes de codificação que deseja executar (ex.: Claude Code, Gemini CLI, Codex ou personalizados).
4. Crie e execute um item de trabalho:
   • Crie um item de trabalho, aponte para um repo, atribua um agente e inicie a execução.
   • Alternativamente, abra a barra de comandos (Ctrl+K), descreva o que quer construir e deixe o orquestrador criar itens de trabalho e enfileirá-los.
5. Revise e faça merge:
   • Quando itens de trabalho chegarem à revisão, aprove para enviar mudanças ao origin.
   • Rejeite para fornecer feedback; o Mozzie inclui o histórico completo da tentativa e o motivo da rejeição no prompt do próximo agente.

Casos de Uso

• Divida uma solicitação de feature em tarefas de codificação paralelas: Descreva uma mudança maior via barra de comandos; o Mozzie a divide em itens de trabalho e executa agentes suportados simultaneamente para gerar branches revisáveis.
• Trabalhe em um repo mantendo saídas de agentes isoladas: Ao experimentar múltiplas abordagens, cada item de trabalho roda em seu próprio git worktree e branch para evitar que execuções de agentes interfiram umas nas outras.
• Gerencie dependências multi-etapa (ex.: scaffolding e depois implementação): Crie itens de trabalho com dependências para que itens bloqueados iniciem automaticamente após conclusão dos pré-requisitos, com detecção de ciclos para evitar planos circulares.
• Itere após tentativas falhas com feedback estruturado: Rejeite um item de trabalho na revisão e inclua feedback; o Mozzie injeta o histórico completo da tentativa (incluindo motivo da rejeição) na próxima execução para reduzir repetição de erros.
• Gerencie múltiplos projetos em uma sessão do app desktop: Use suporte a multi-workspace para executar e revisar itens de trabalho em mais de um repositório na mesma app.

FAQ

• O Mozzie exige conexão com a nuvem para funcionar? Mozzie é local-first e funciona totalmente offline.

• Quais agentes de IA de codificação ele pode executar? O repositório lista suporte nativo para Claude Code (via transporte ACP/stdio), Gemini CLI, Codex CLI e CLIs/scripts personalizados.

• Como o Mozzie evita conflitos entre agentes? Ele cria git worktrees e branches isolados por item de trabalho, para que execuções simultâneas não compartilhem o mesmo diretório de trabalho.

• O que acontece se eu rejeitar um item de trabalho na revisão? Mozzie inclui o histórico completo da tentativa e o motivo da rejeição no próximo prompt do agente, e o estado pode voltar da revisão para uma reexecução.

• Os itens de trabalho podem depender uns dos outros? Sim. Mozzie suporta grafo de dependências, lança automaticamente itens bloqueados quando as dependências terminam e inclui detecção de ciclos.

Alternativas

• Ferramentas de IDE de agente único ou assistentes de codificação baseados em chat: Úteis quando você quer uma sessão de agente por vez; geralmente não oferecem a mesma orquestração de dependências de itens de trabalho e isolamento via git worktree.
• Executores de scripts locais que despacham múltiplas tarefas para CLIs: Você pode paralelizar comandos de agentes, mas precisaria construir orquestração, gerenciamento de dependências e fluxo de revisão manualmente.
• Automação baseada em CI/CD para geração de código e revisão de PR: Pode lidar com gates de revisão e branching, mas é menos focada em um fluxo de orquestração local interativo “uma janela só”.
• Ferramentas de workflow/orquestração para agentes de IA sem git worktrees local-first: Podem coordenar chamadas de agentes, mas podem não oferecer o isolamento específico via git worktree e fluxo de merge de stack-branch descrito para o Mozzie.