Mozzie

¿Qué es Mozzie?

Mozzie es una app de escritorio local-first que orquesta agentes de codificación con IA como una fuerza laboral gestionada. En lugar de ejecutar una sola sesión de agente a la vez, describes lo que quieres construir y Mozzie divide el trabajo en ítems, ejecuta múltiples agentes en paralelo y coordina su salida a través de un flujo de trabajo basado en git.

La app está diseñada para mantener el trabajo y la orquestación en tu máquina. Crea worktrees de git aislados por ítem de trabajo, gestiona dependencias entre ítems y proporciona un flujo de revisión para que apruebes o rechaces cambios antes de hacer merge.

Características clave

• Ejecución local-first con flujo de trabajo offline: Usa una base de datos SQLite local y ejecuta todo en tu máquina, incluido el flujo de ejecución de agentes.
• Orquestación en lenguaje natural en ítems de trabajo: El orquestador convierte tu solicitud en ítems de trabajo, establece el orden de ejecución y asigna agentes.
• Soporte para múltiples agentes en paralelo: Ejecuta varios agentes de codificación de forma concurrente, con soporte integrado para Claude Code, Gemini CLI, Codex CLI y CLIs/scripts personalizados.
• Aislamiento por git worktree por ítem de trabajo: Cada ítem de trabajo se ejecuta en su propio worktree y rama, reduciendo conflictos entre ejecuciones de agentes.
• Flujo de revisión + merge: Al finalizar un agente, Mozzie proporciona un paso de diff/revisión; aprobar empuja a origin, rechazar envía feedback a la siguiente tentativa.
• Grafo de dependencias con auto-lanzamiento de ítems bloqueados: Los ítems de trabajo pueden depender unos de otros; los bloqueados se lanzan automáticamente al completarse dependencias, con detección de ciclos incluida.
• Sub-ítems de trabajo (ramas apiladas) y merge padre/hijo: Las ramas hijas se mergean en un ítem de trabajo padre; el padre empuja a origin como un solo PR.
• Conversaciones persistentes entre sesiones: El contexto del orquestador se preserva para que retomes donde lo dejaste.
• Streaming en vivo de la salida de agentes: Puedes ver la salida de agentes en tiempo real, incluida la visualización de actividad de tool-call.

Cómo usar Mozzie

1. Instala prerrequisitos: Usa Node >= 20, pnpm >= 9, Rust (stable) y los prerrequisitos de Tauri específicos de la plataforma. Asegúrate de tener al menos un CLI de agente de codificación con IA instalado.
2. Configura la app:
   • Clona el repositorio e instala dependencias (pnpm install).
   • Inicia la app de desarrollo (pnpm dev). La app se abrirá.
3. Configura proveedores y agentes:
   • En Open Settings (ícono de engranaje), añade claves API para tu proveedor de LLM orquestador (OpenAI, Anthropic o Gemini).
   • Añade configuraciones de agentes para los agentes de codificación que quieras ejecutar (p. ej., Claude Code, Gemini CLI, Codex o personalizados).
4. Crea y ejecuta un ítem de trabajo:
   • Crea un ítem de trabajo, apúntalo a un repo, asigna un agente e inicia la ejecución.
   • Alternativamente, abre la barra de comandos (Ctrl+K), describe lo que quieres construir y deja que el orquestador cree ítems de trabajo y los encolé.
5. Revisa y mergea:
   • Cuando los ítems de trabajo lleguen a revisión, aprueba para empujar cambios a origin.
   • Rechaza para dar feedback; Mozzie incluye el historial completo de intentos y tu razón de rechazo en el siguiente prompt del agente.

Casos de uso

• Divide una solicitud de función en múltiples tareas de codificación paralelas: Describe un cambio mayor vía la barra de comandos; Mozzie lo divide en ítems de trabajo y ejecuta agentes compatibles concurrentemente para producir ramas revisables.
• Trabaja en un repo manteniendo salidas de agentes aisladas: Al experimentar con múltiples enfoques, cada ítem de trabajo se ejecuta en su propio git worktree y rama para evitar que las ejecuciones de agentes se pisen.
• Maneja dependencias multi-paso (p. ej., scaffolding e implementación): Crea ítems de trabajo con dependencias para que los bloqueados se lancen automáticamente solo tras completarse los prerrequisitos, con detección de ciclos para evitar planes circulares.
• Itera tras intentos fallidos con feedback estructurado: Rechaza un ítem de trabajo en revisión e incluye feedback; Mozzie inyecta el historial completo de intentos (incluida tu razón de rechazo) en la siguiente ejecución para reducir repeticiones de errores.
• Gestiona múltiples proyectos desde una sesión de app de escritorio: Usa soporte multi-workspace para ejecutar y revisar ítems de trabajo en más de un repositorio dentro de la misma app.

Preguntas frecuentes

• ¿Requiere Mozzie conexión a la nube para funcionar? Mozzie es local-first y funciona completamente sin conexión.

• ¿Qué agentes de codificación con IA puede ejecutar? El repositorio enumera soporte integrado para Claude Code (vía transporte ACP/stdio), Gemini CLI, Codex CLI y CLIs/scripts personalizados.

• ¿Cómo evita Mozzie conflictos entre agentes? Crea git worktrees y branches aislados por elemento de trabajo, por lo que las ejecuciones concurrentes no comparten el mismo directorio de trabajo.

• ¿Qué pasa si rechazo un elemento de trabajo durante la revisión? Mozzie incluye el historial completo del intento y la razón de rechazo en el siguiente prompt del agente, y el estado puede volver de revisión a una ruta de reejecución.

• ¿Pueden los elementos de trabajo depender unos de otros? Sí. Mozzie soporta un grafo de dependencias, lanza automáticamente elementos bloqueados al completarse las dependencias e incluye detección de ciclos.

Alternativas

• Herramientas de IDE de agente único o asistentes de codificación basados en chat: Útiles cuando quieres una sesión de agente a la vez; normalmente no ofrecen la misma orquestación de dependencias de elementos de trabajo y aislamiento por git worktree.
• Ejecutores de scripts locales que despachan múltiples tareas a CLIs: Puedes paralelizar comandos de agentes, pero tendrías que construir tú mismo la orquestación, gestión de dependencias y flujo de revisión.
• Automatización basada en CI/CD para generación de código y revisión de PR: Puede manejar puertas de revisión y ramificación, pero está menos orientada a un flujo de orquestación local interactivo “una ventana”.
• Herramientas de flujo/orquestación para agentes de IA sin git worktrees local-first: Pueden coordinar llamadas de agentes, pero no ofrecen el aislamiento específico por git worktree y flujo de fusión de branches descrito para Mozzie.