sawyer-plugins
Sawyer Hood's BB plugins, in one repository. Every plugin lives under plugins/<id>/ as an ordinary plugin package with its own package.json, and .bb/plugins.json indexes them as a collection.
| Plugin | Directory | What it does |
|---|
| Better Notes | plugins/better-notes | An editable fork of BB’s built-in document and notes library. |
| Cascade | plugins/cascade | A scrollable, tiled layout for active BB threads. |
| Compact Nav | plugins/compact-nav | Borderless sidebar icon buttons with native ordering and visibility controls. |
| CoW copy | plugins/btrfs-cow | An environment provider that uses copy-on-write reflink copies instead of git worktrees (Btrfs/XFS). |
| Magic Compose | plugins/magic-compose | A wand beside the send button on the new-thread composer: switch it on and Jev picks the project, machine, model, reasoning level, and environment as you type. |
| Miku Companion | plugins/miku | An event-aware Hatsune Miku companion and theme. |
| Nav Rail | plugins/nav-rail | Sidebar navigation as a vertical icon rail on the left, with New thread beside the back and forward buttons. |
| OpenRouter Inference | plugins/openrouter-inference | Thread titles, commit messages, and voice transcription from OpenRouter models, with your own API key. |
| Pokémon | plugins/pokemon | Catch a random Pokémon every time you archive a thread, and fill out your Pokédex. |
| Quick Chat | plugins/quick-chat | A floating chat window for quick, projectless questions. |
| Quick Compose | plugins/quick-compose | A floating new-thread composer you can open from anywhere. |
| SlopCop | plugins/slopcop | Automated GitHub issue and PR rules that dispatch BB agents. |
| T3 Sidebar | plugins/t3sidebar | An inbox-style sidebar for BB threads. |
Install
Most of these plugins are listed in the BB community marketplace, so the easiest path is the marketplace UI or bb plugin install <id>.
To install straight from this repository, pick one plugin directory:
bb plugin install git:https://github.com/SawyerHood/sawyer-plugins.git --plugin miku
Or pin a semver range over that plugin's release tags:
bb plugin install git:https://github.com/SawyerHood/sawyer-plugins.git@^0.6.0 --subdirectory plugins/miku --tag-prefix miku/
Releases
Each plugin is versioned and tagged on its own as <id>/vX.Y.Z (for example miku/v0.6.0). Bump the plugin's package.json version, commit, then tag that commit with the matching prefix.
Development
Each plugin directory is self-contained: run npm install inside it, then npm run typecheck, npm test, or npm run build as its package.json defines. See each plugin's README for details.
History
These plugins were previously published from separate repositories (bb-plugin-cascade, bb-plugin-compact-nav, bb-plugin-btrfs-cow, bb-plugin-miku, bb-slop-cop, and bb-plugin-t3sidebar). Their full commit history was merged into this repository with git subtree.
License
MIT.
