Skip to main content
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 Exchange browsing view

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
Playbook Exchange detail view

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

ActionKey
Navigate tilesArrow keys
Open detail viewEnter
Close / BackEsc