Files
Maestro/docs/playbook-exchange.md
Pedram Amini 5c4eb2d55b ## CHANGES
- 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 🆘
2025-12-28 17:50:03 -06:00

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

  1. Open the detail view for a playbook
  2. Optionally edit the Import to folder field (defaults to category/title slug)
  3. 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