Mozzie

Cos'è Mozzie?

Mozzie è un’app desktop local-first che coordina agenti di coding AI come una forza lavoro gestita. Invece di eseguire una singola sessione agente alla volta, descrivi ciò che vuoi creare e Mozzie suddivide il lavoro in item, esegue più agenti in parallelo e coordina i loro output tramite un workflow basato su git.

L’app è progettata per mantenere il lavoro e l’orchestrazione sulla tua macchina. Crea worktree git isolati per ogni item di lavoro, gestisce le dipendenze tra item e fornisce un flusso di revisione per approvare o rifiutare le modifiche prima del merge.

Caratteristiche Principali

• Esecuzione local-first con workflow offline: Utilizza un database SQLite locale ed esegue tutto sulla tua macchina, incluso il workflow di esecuzione degli agenti.
• Orchestrazione in linguaggio naturale in item di lavoro: L’orchestrator converte la tua richiesta in item di lavoro, imposta l’ordine di esecuzione e assegna gli agenti.
• Supporto multi-agente parallelo: Esegue più coding agent contemporaneamente, con supporto integrato per Claude Code, Gemini CLI, Codex CLI e CLI/script personalizzati.
• Isolamento git worktree per item di lavoro: Ogni item di lavoro viene eseguito nel proprio worktree e branch, riducendo i conflitti tra esecuzioni agente.
• Workflow di revisione + merge: Al termine di un agente, Mozzie fornisce un passo diff/revisione; approva per push su origin, rifiuta per feedback nel tentativo successivo.
• Grafo di dipendenze con auto-lancio item bloccati: Gli item di lavoro possono dipendere l’uno dall’altro; gli item bloccati si avviano automaticamente al completamento delle dipendenze, con rilevamento cicli incluso.
• Sub-item di lavoro (branch stacked) e merge genitore/figlio: I branch figli mergiano in un item genitore; il genitore pusha su origin come un unico PR.
• Conversazioni persistenti tra sessioni: Il contesto dell’orchestrator è preservato per riprendere da dove eri rimasto.
• Streaming live dell’output agente: Puoi osservare l’output agente in tempo reale, inclusa la visualizzazione dell’attività tool-call.

Come Usare Mozzie

1. Installa i prerequisiti: Usa Node >= 20, pnpm >= 9, Rust (stable) e i prerequisiti Tauri specifici della piattaforma. Assicurati che almeno un CLI di coding agent AI sia installato.
2. Configura l’app:
   • Clona il repository e installa le dipendenze (pnpm install).
   • Avvia l’app di sviluppo (pnpm dev). L’app si aprirà.
3. Configura provider e agenti:
   • In Open Settings (icona ingranaggio), aggiungi chiavi API per il tuo provider LLM orchestrator (OpenAI, Anthropic o Gemini).
   • Aggiungi configurazioni agente per i coding agent da eseguire (es. Claude Code, Gemini CLI, Codex o custom).
4. Crea ed esegui un item di lavoro:
   • Crea un item di lavoro, puntalo a un repo, assegna un agente e avvia l’esecuzione.
   • In alternativa, apri la command bar (Ctrl+K), descrivi ciò che vuoi creare e lascia che l’orchestrator generi item di lavoro e li metta in coda.
5. Rivedi e mergia:
   • Quando gli item di lavoro raggiungono la revisione, approva per push delle modifiche su origin.
   • Rifiuta per fornire feedback; Mozzie include la cronologia completa del tentativo e il motivo del rifiuto nel prompt del prossimo agente.

Casi d’Uso

• Suddividi una richiesta feature in task di coding paralleli: Descrivi un cambiamento più ampio tramite command bar; Mozzie lo suddivide in item di lavoro e esegue agenti supportati in parallelo per produrre branch revisionabili.
• Lavora su un repo mantenendo output agente isolati: Durante esperimenti con approcci multipli, ogni item di lavoro esegue nel proprio git worktree e branch per evitare che le esecuzioni agente si sovrappongano.
• Gestisci dipendenze multi-step (es. scaffolding poi implementazione): Crea item di lavoro con dipendenze così che gli item bloccati si avviino automaticamente solo dopo il completamento dei prerequisiti, con rilevamento cicli per prevenire piani circolari.
• Itera dopo tentativi falliti con feedback strutturato: Rifiuta un item di lavoro in revisione e includi feedback; Mozzie inietta la cronologia completa del tentativo (incluso il motivo del rifiuto) nella prossima esecuzione per ridurre errori ripetuti.
• Gestisci più progetti da una sessione app desktop: Usa il supporto multi-workspace per eseguire e rivedere item di lavoro su più di un repository nella stessa app.

FAQ

• Mozzie richiede una connessione cloud per funzionare? Mozzie è local-first e funziona completamente offline.

• Quali agenti di coding AI può eseguire? Il repository elenca il supporto integrato per Claude Code (via trasporto ACP/stdio), Gemini CLI, Codex CLI e CLI/script personalizzati.

• Come impedisce Mozzie i conflitti tra agenti? Crea git worktree e branch isolati per ogni item di lavoro, così le esecuzioni concorrenti non condividono la stessa directory di lavoro.

• Cosa succede se rifiuto un item di lavoro durante la revisione? Mozzie include la cronologia completa del tentativo e il motivo del rifiuto nel prompt successivo dell’agente, e lo stato può passare dalla revisione a un percorso di re-esecuzione.

• Gli item di lavoro possono dipendere l’uno dall’altro? Sì. Mozzie supporta un grafo di dipendenze, avvia automaticamente gli item bloccati al completamento delle dipendenze e include il rilevamento di cicli.

Alternative

• Strumenti IDE single-agent o assistenti di coding basati su chat: Utili quando vuoi una sessione agente alla volta; di solito non offrono la stessa orchestrazione delle dipendenze degli item di lavoro e isolamento git worktree.
• Runner di script locali che dispatchano più task a CLI: Puoi parallelizzare i comandi agente, ma dovresti implementare tu orchestrazione, gestione dipendenze e workflow di revisione.
• Automazione basata su CI/CD per generazione codice e revisione PR: Può gestire gate di revisione e branching, ma è meno orientata a un workflow di orchestrazione locale interattivo “una finestra sola”.
• Strumenti di workflow/orchestrazione per agenti AI senza git worktree local-first: Possono coordinare chiamate agente, ma potrebbero non offrire l’isolamento git worktree specifico e il workflow di merge stack-branch descritto per Mozzie.