paseo-bm
by hieunt286Beads Management for Paseo — the plugin payload: the Metric, Beads and Setup screens plus the agent role instructions. Install with npx paseo-bm, which also registers the three agent roles.
Gallery
Supported platforms: macOS, Linux.
- Install with
npx paseo-bm: it also registers the three bm-* agent roles the plugin needs. There is no other supported install. - Installed straight from this page the screens load, but the three bm-* agent roles are missing, so the Manager cannot create a Worker.
- Stable 0.3.0 on npm: commands, flags, exit codes and the --json shape are a public contract and change only with a new version.
- Requires Paseo 0.8.0+, Node 22+, the paseo CLI on PATH, macOS or Linux (no Windows), plus the br and bv Beads CLIs.
- Enabling Paseo's agent tools grants them to every agent on the machine, not only paseo-bm's roles.
- The Worker runs without permission prompts; its limits are role instructions only, so review git diff before you commit.
Install
npmjs · Paseo 0.9+
paseo plugin add npm:paseo-bm-plugin@0.3.0Previewv0.3.0-alpha.7 · npm dist-tag: next
Preview releases are unreleased plugin code. Install only if you want to test it; stable remains the default. Published 2026-09-24.
Security scan passed · 0 blocking · 0 advisory.
paseo plugin add npm:paseo-bm-plugin@0.3.0-alpha.7GitHub · Paseo 0.8 fallback
paseo plugin add hieunt286/paseo-bm --ref 4ebdca65c19eb0a4a6a3ad331600cb2f371dae1c --path pluginGit security status and fallback installation are pinned to commit 4ebdca65c19e.
README
paseo-bm-plugin — the paseo-bm payload
This package is the plugin payload of paseo-bm: the screens it contributes to Paseo and the instructions its three agent roles run on. Loading it gives you Metric (what each request did and cost), Beads (the workspace's beads) and Setup (tools, skills and role instructions).
Install paseo-bm with npx paseo-bm
npx paseo-bm
That is the supported install, and it is what you want. The installer copies this payload to a
stable path, registers it with the Paseo daemon, registers the three agent roles bm-manager,
bm-worker and bm-reviewer, and asks for the consent those roles need.
Limitations of installing this package directly
You can point Paseo at this payload on its own:
# Paseo 0.9 and newer — npm source
paseo plugin add npm:paseo-bm-plugin@<version>
# Paseo 0.8 — Git source; 0.8 has no npm source type
paseo plugin add hieunt286/paseo-bm --ref <commit> --path plugin
Either way the plugin loads and the screens appear, but the three agent roles are missing,
because the installer registers them, not the payload. Without those roles the Beads Manager cannot
create a Worker, so the product does not work end to end. Use npx paseo-bm instead.
Everything else worth knowing before you install — what paseo-bm writes on your machine, that Paseo plugins run without a sandbox, and that the Worker runs without permission prompts — is in GUIDE.md.
Versions
This package always carries the same version as the paseo-bm CLI, published from the same commit
in the same release.
Documentation
- Repository and README
- GUIDE.md — requirements, install options, the screens, commands, exit codes, troubleshooting
- Guided tour
License
MIT, see LICENSE.
Scanned 25 Sep 2026, 05:38 UTC from hieunt286/paseo-bm/plugin.