diff --git a/README.md b/README.md index 8ae4c0f2..6e055522 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,8 @@ Collaborate with AI to create detailed specification documents, then let Auto Ru Run multiple agents in parallel with a Linear/Superhuman-level responsive interface. Currently supporting **Claude Code**, **OpenAI Codex**, **OpenCode**, and **Factory Droid** with plans for additional agentic coding tools (Gemini CLI, Qwen3 Coder) based on user demand. +> **How It Works:** Maestro is a pass-through to your AI provider. Whatever MCP tools, skills, permissions, or authentication you have configured in Claude Code, Codex, or OpenCode works identically in Maestro. The only difference is we're not running interactively—each task gets a prompt and returns a response, whether it's a new session or resuming a prior one. +
+Maestro is a pass-through to your provider. Your MCP tools, custom skills, permissions, and authentication all work in Maestro exactly as they do when running the provider directly. The only difference is batch mode execution—Maestro sends a prompt and receives a response rather than running an interactive session. + + **Option A: Quick Setup** Create your first agent manually using the **+** button in the sidebar. diff --git a/docs/installation.md b/docs/installation.md index 39b151e7..17565244 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -23,6 +23,10 @@ Download the latest release for your platform from the [Releases](https://github - [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Qwen3 Coder](https://github.com/QwenLM/Qwen-Agent) — Planned support - Git (optional, for git-aware features) + +Maestro is a pass-through to your provider. Your MCP tools, custom skills, permissions, and authentication all work in Maestro exactly as they do when running the provider directly—Maestro just orchestrates the conversation flow in batch mode. + + ## WSL2 Users (Windows Subsystem for Linux) diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index b78e39bd..42d4f7e4 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -4,6 +4,18 @@ description: System logs, process monitor, debug packages, and how to get help w icon: life-ring --- +## Frequently Asked Questions + +**Do my MCP tools, skills, and permissions work in Maestro?** + +Yes. Maestro is a pass-through—it calls your provider (Claude Code, Codex, OpenCode) in batch mode rather than interactive mode. Whatever works when you run the provider directly will work in Maestro. Your MCP servers, custom skills, authentication, and tool permissions all carry over automatically. + +**What's the difference between running the provider directly vs. through Maestro?** + +The only difference is execution mode. When you run Claude Code directly, it's interactive—you send a message, watch it work, and respond in real-time. Maestro runs in batch mode: it sends a prompt, the provider processes it fully, and returns the response. This enables unattended automation via Auto Run and parallel agent management. Everything else—your tools, permissions, context—remains identical. + +--- + ## System Logs Maestro maintains detailed system logs that help diagnose issues. Access them via: diff --git a/src/renderer/components/WelcomeContent.tsx b/src/renderer/components/WelcomeContent.tsx index 4930196d..e6756cab 100644 --- a/src/renderer/components/WelcomeContent.tsx +++ b/src/renderer/components/WelcomeContent.tsx @@ -89,7 +89,7 @@ export function WelcomeContent({ theme, showGetStarted = false }: WelcomeContent {/* How it works section */}

How it works:{' '} + Maestro is a pass-through to your AI provider. Your MCP tools, skills, + and permissions work exactly as they do when running the provider directly. +

+

Agents run in auto-approve mode with tool calls accepted automatically. Toggle Read-Only mode for guardrails.