Beads Agent Project Manager

Plan dependency-linked work, coordinate ready tasks across agents, and track verified progress with Beads.

The plugin provides:

the portable beads-project-manager skill;
a Beads Project Manager custom agent for GitHub Copilot clients.

It uses the bd executable installed in the active environment. It does not bundle Beads, install software, initialize a project, or expose the Beads Git Graph VSIX as an MCP server.

Start safely

Confirm that Beads is already available with bd --version.
Select Beads Project Manager in Chat.
Start with a read-only prompt:

Inspect this repository read-only. Show the ready tasks, dependency waves, and proposed owners.
Do not mutate Beads or start agents.

Starting parallel agents requires compatible agent or task tools from the host client. When those tools are unavailable, the plugin produces a reviewable allocation plan instead of claiming that workers were started.

For subagent work, the plugin shows the parent-to-leaf plan and dependency waves in chat, followed by updates when the host reports a meaningful execution change. Reports separate requested provider/model, known worker identity, recorded Beads status, observed phase, and pending review. They are not live telemetry in the VSIX GUI: the plugin has no Extension Host progress API. Supported Beads metadata may be recorded with the task's write authorization and viewed on refresh.

The skill instructs the agent to read repository instructions first, feature-detect the installed Beads command surface, and use read-only queries before proposing mutations. It also instructs the agent never to automatically run bd migrate, bd bootstrap, or --ignore-schema-skew. Agent output is not treated as accepted work until the actual artifact and its acceptance checks have been verified.

See the repository's installation and safety notes before installing. Release history is recorded in CHANGELOG.md.