| name | beads |
| description | Manage issues, track dependencies, and monitor workspace progress via CLI. Use when user needs to create/list/update issues, manage blockers, claim work, or get project stats. |
| source_version | 3.2.0 |
| source_cli_hash | 07387276 |
| generated_at | 2026-04-06T08:53:07.680832+00:00 |
beads (via mcp2cli)
Lightweight issue tracker with dependency management and workspace context.
Shortcuts
No shortcuts defined. Base command: mcp2cli beads <cmd>
Commands
Issue
| Command | Description | Example | Ref |
|---|
mcp2cli beads issue create | Create a new issue | mcp2cli beads issue create --title "Fix memory leak" --issue-type bug
mcp2cli beads issue create --title "Add login" --issue-type feature --assignee alice | ref |
mcp2cli beads issue get | Get detailed issue info | mcp2cli beads issue get --issue-id ISSUE-1 | ref |
mcp2cli beads issue list | List issues with filters | mcp2cli beads issue list --status open --assignee alice | ref |
mcp2cli beads issue update | Update issue fields | mcp2cli beads issue update --issue-id ISSUE-1 --status in_progress | ref |
mcp2cli beads issue close | Close/complete an issue | mcp2cli beads issue close --issue-id ISSUE-1 | ref |
mcp2cli beads issue claim | Atomically claim an issue for work | mcp2cli beads issue claim --issue-id ISSUE-1 | ref |
mcp2cli beads issue ready | Find issues with no blockers | mcp2cli beads issue ready
mcp2cli beads issue ready --assignee alice --limit 5 | ref |
mcp2cli beads issue blocked | Get blocked issues | mcp2cli beads issue blocked | ref |
Workspace
| Command | Description | Example | Ref |
|---|
mcp2cli beads dep | Add dependency between issues | mcp2cli beads dep --issue-id ISSUE-2 --depends-on-id ISSUE-1 | ref |
mcp2cli beads stats | Get issue statistics | mcp2cli beads stats | ref |
mcp2cli beads context | Manage workspace context | mcp2cli beads context --action show | ref |
mcp2cli beads admin | Admin/diagnostic operations | mcp2cli beads admin --action validate | ref |
mcp2cli beads tool list | List available tools | mcp2cli beads tool list | ref |
Discover Parameters
Append --help to any command for full parameter list:
mcp2cli beads issue create --help
Note: Use Ref links in the Commands table above to view detailed parameter reference and more examples.
User Notes
MUST READ users/skill.md for custom workflows and tips.
Config: MCP server settings live in ~/.agents/mcp2cli/servers.yaml - edit there to take effect.
