Support & Community
Welcome to the Maestro community! Whether you’re looking for help, want to share your experience, or contribute to the project, we have several channels available.Getting Help
Documentation
Start with our comprehensive documentation:Getting Started
New to Maestro? Start here
General Usage
Core features and workflows
Keyboard Shortcuts
Essential keyboard shortcuts
Troubleshooting
Common issues and solutions
Discord Community
Join our Discord server for real-time help and discussions: Join Maestro Discord The Discord community is great for:- Getting quick answers to questions
- Sharing tips and workflows
- Discussing feature ideas
- Connecting with other Maestro users
- Showcasing what you’ve built
GitHub Discussions
For longer-form discussions and questions: GitHub Discussions Use Discussions for:- Feature requests and ideas
- General questions about usage
- Sharing playbooks and workflows
- Community showcase
Reporting Issues
Bug Reports
Found a bug? Please report it on GitHub: Create a Bug Report When reporting a bug, please include:System Information
- Operating system and version
- Maestro version (Help → About)
- Agent type (Claude Code, Codex, OpenCode, etc.)
Additional Context
- Screenshots if applicable
- Relevant logs (see Troubleshooting)
- Error messages
Feature Requests
Have an idea for a new feature? Request a Feature Describe:- The problem you’re trying to solve
- How the feature would work
- Why it would be valuable to other users
Performance Issues
Experiencing UI lag or slowness? We can help diagnose it. See our Performance Profiling Guide for instructions on capturing diagnostic data.Contributing
Want to contribute code, documentation, or playbooks?Contributing Guide
Development setup and guidelines
Share Playbooks
Contribute to the Playbook Exchange
- Bug fixes
- New features
- Documentation improvements
- UI/UX enhancements
- Test coverage
- Playbook creation
Social Media
Stay updated on Maestro news and releases:- Twitter/X: @RunMaestro
- BlueSky: @runmaestro.ai
- GitHub: RunMaestro/Maestro
Team
Meet the team behind Maestro at runmaestro.ai/team.Community Guidelines
When participating in the Maestro community:Do:
- Be respectful and constructive
- Help others when you can
- Search before asking (your question may be answered already)
- Provide context when asking for help
- Share what you’ve learned
Frequently Asked Questions
Can I use Maestro commercially?
Yes! Maestro is licensed under AGPL-3.0, which allows commercial use. See the LICENSE for details.Is my data private?
Yes. Maestro runs entirely on your local machine. Conversations, files, and configuration are stored locally. The only data sent externally is:- AI prompts to your chosen provider (Claude, Codex, etc.)
- Optional crash reports via Sentry (can be disabled in Settings)
- Optional leaderboard stats (requires explicit opt-in)
Which AI providers are supported?
Currently:- Claude Code (Anthropic)
- OpenAI Codex
- OpenCode
- Factory Droid
Can I run Maestro on a server?
Yes! Use the CLI tool (maestro-cli) for headless operation. See CLI Documentation.
Does Maestro work offline?
The Maestro UI works offline, but AI agents require internet access to communicate with their respective providers.How do I update Maestro?
Enable auto-updates in Settings → General → Updates. Or download the latest release from GitHub Releases.Additional Resources
Documentation
Full documentation site
GitHub Repo
Source code and releases
Discord
Join the community
MCP Server
Connect AI apps to docs
Security Policy
Report security issues
Changelog
Version history
Still have questions? Don’t hesitate to ask in Discord or GitHub Discussions!