Xu Maestro

XuMaestro 🎭

**XuMaestro** is a powerful and flexible workflow orchestrator for AI agents (Gemini & Claude). it allows you to define complex sequences of automated tasks, manage loops over files, include sub-workflows, and track execution in real-time through a modern interface.

---

🌟 Features

• YAML Configuration: Define your workflows simply in YAML files.
• AI-Powered Workflow Generation: Instantly create complex YAML workflows from a simple text description using AI.
• Multi-Engine Support: Native support for both gemini-cli and claude-code.
• Real-Time Execution: Follow progress, logs, and agent exchanges via a SSE (Server-Sent Events) stream.
• Loop System (loop): Automatically iterate over lists of files using glob patterns.
• Workflow Composition: Reuse existing workflows as steps using the sub-workflow engine.
• Interactivity: Agents can pause execution to ask questions to the user.
• Resilience & Checkpoints: Error management, automatic retries (mandatory mode), and resumption from the last successful checkpoint.
• Context Isolation: Each step enriches the shared context while maintaining clean isolation during loop iterations.
• Parallel Execution: Run independent agents simultaneously using the parallel: block to reduce total run time.
• Git Checkpoints (Auto-Commit): Automatically commit changes after each successful agent execution with AI-generated commit messages.

---

📸 Screenshots

Real-Time Execution & Completion

 *Track agent progress and view final outputs in real-time.*

Parallel Agent Execution

 *Run multiple agents simultaneously to optimize total execution time.*

AI-Powered Workflow Generation

 *Generate complex YAML workflows instantly from a simple text description.*

Interactive Agent Questions

![Interactive Question](docs/question.p