paseo-bm-plugin — Beads Management for Paseo

paseo-bm is a small agent team and dashboard for Paseo, organised by mission: one goal you name, across every repository it needs. Each mission's Main (a Beads Manager) gives each change to a Worker in the right repository, links Workers that must agree, keeps what is in flight and asks you only what is yours to decide; a Reviewer checks larger work, and the optional Orchestrator governs the missions' process at the autonomy level you choose.

Visit the paseo-bm website for a guided overview of the plugin.

What is included

• Missions with each mission's Main, level, repositories, Workers, done criteria, what is in flight and the Main's history.
• A Mission-List project in Paseo with one workspace per mission.
• Inbox for decisions and alerts that need you.
• Projects with request timelines, Beads, metrics and agents per repository.
• Settings for repository and mission autonomy, coordination, roles, updates and release notes.
• Tools & skills for workflow skills, agent tools, br and bv.
• Main (Beads Manager), Worker, Reviewer and optional machine-wide Orchestrator roles.

Install and start

Requires Paseo 0.9.0 or newer on macOS or Linux.

paseo plugin add npm:paseo-bm-plugin

Open Beads Manager. The first open creates the four bm-* role profiles with an available provider/model. Then:

1. Choose Allow agent tools in Settings → More → Agents.
2. Choose Install skills and install br / bv in Tools & skills when shown.
3. In Missions, choose New mission: a name, a short code, a goal, its repositories and a level. Its Main opens in the mission's own workspace.
4. Tell the Main the outcome you want; it gives each change to a Worker in the right repository.

Update and see what changed

Settings shows the installed/latest version and release notes. When an update is available, choose Update now and confirm it, or run:

paseo plugin update paseo-bm

Every version links to its release-note source in the repository. The same file is used for GitHub Releases and the in-plugin changelog.

Before you install

• Paseo plugins run without a sandbox and have the daemon's machine access.
• Allow agent tools is a machine-wide Paseo switch, not limited to paseo-bm.
• Workers run without interactive permission prompts. Review the diff before committing.
• Install skills runs the third-party skills CLI, which downloads another author's project.
• Starting the Orchestrator sends masked project context to its model provider and uses provider tokens.

See the full safety and data guide.

Remove

Open Settings → More → Data, choose Remove paseo-bm's settings…, then run:

paseo plugin remove paseo-bm

Paseo has no plugin-removal hook, so skipping the Settings action leaves the bm-* configuration behind.

If you installed paseo-bm with npx paseo-bm before

That is a directory install. If Paseo reports:

Plugin ID "paseo-bm" is already configured; choose another ID with --id

Do not choose another id. Follow the migration guide and run the one-time command npx paseo-bm@0.4.0.

Links

• Plugin website and guided tour
• Full guide
• Release notes
• Troubleshooting: paseo plugin ls and paseo plugin logs paseo-bm

MIT licensed. See LICENSE.