- Rebranded Playbook Marketplace into Playbook Exchange across docs and UI 🔄 - Added dedicated IPC handlers to fetch and import Exchange playbooks ⚙️ - Wired Playbook Exchange launch action through App modals and Auto Run 🧩 - Introduced Playbook Exchange quick action for one-keystroke access ⌨️ - Added Exchange button directly inside Batch Runner for faster discovery 🧰 - Upgraded Exchange detail view with clickable document list and “Read more” 📚 - Improved markdown preview styling with themed prose and link handling 🖋️ - Added folder picker to import playbooks into chosen relative/absolute paths 📂 - Introduced in-modal help popover with submission link to community repo 🆘
2.4 KiB
title, description, icon
| title | description | icon |
|---|---|---|
| Playbook Exchange | Browse, preview, and import community playbooks from the Maestro Playbook Exchange. | store |
The Playbook Exchange is a curated collection of community-contributed playbooks that you can browse and import directly into your Auto Run folder. Each playbook is a pre-configured set of markdown documents designed for specific workflows.
Opening the Exchange
Open the Playbook Exchange using:
- Quick Actions:
Cmd+K→ search "Playbook Exchange" - Auto Run panel: Click the Playbook Exchange button
Browsing Playbooks
The exchange displays playbooks in a searchable grid organized by category:
- Category tabs filter playbooks by type (Development, Security, DevOps, etc.)
- Search filters by title, description, and tags
- Arrow keys navigate between tiles
- Enter opens the detail view for the selected playbook
Use Cmd+Shift+[ / Cmd+Shift+] to quickly switch between category tabs.
Playbook Details
Clicking a playbook tile opens the detail view where you can:
- Read the README — full documentation for the playbook
- Preview documents — browse individual task documents before importing
- View metadata — author, tags, loop settings, and document list
- Set import folder — customize the target folder name
Importing a Playbook
- Open the detail view for a playbook
- Optionally edit the Import to folder field (defaults to
category/titleslug) - Click Import Playbook
The import creates:
- A subfolder in your Auto Run folder with the playbook name
- All markdown documents copied to that folder
- A saved playbook configuration with loop settings and document order
After import, the playbook is immediately available in your Load Playbook dropdown in the Auto Run panel.
Exchange Data
Playbooks are fetched from the Maestro-Playbooks GitHub repository. The manifest is cached locally for 5 minutes to minimize API calls.
- Cache indicator shows whether data is from cache and how old it is
- Refresh button forces a fresh fetch from GitHub
Contributing Playbooks
Want to share your playbooks with the community? See the Maestro-Playbooks repository for contribution guidelines.
Keyboard Shortcuts
| Action | Key |
|---|---|
| Navigate tiles | Arrow keys |
| Open detail view | Enter |
| Close / Back | Esc |