72e5abbc73
- Added Playbook Exchange browsing screenshot to docs for instant clarity 🖼️ - Added Playbook Details view screenshot to guide imports and metadata 🔍 - Removed outdated refactor task docs to keep repo leaner 📉 - Upgraded `useScrollPosition` default throttle to 4ms for buttery scroll ⚡ - Updated hook documentation to reflect new ~240fps scroll throttling 📘 - Added a documentation-focused test covering the new default throttle value 🧪
2.7 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 |