Bd
Beads (bd) issue tracker bridge — list, ready, show, create, update, close, reopen, dep, reclaim, and graph issues, plus capture the bd prime workflow context, via the local bd CLI.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| bdCommand? | string | Path to the beads CLI |
| bdDir? | string | Project directory containing a .beads/ database (bd auto-discovers from here) |
| defaultPriority? | number | Default priority for new issues |
| defaultType? | string | Default type for new issues |
| Argument | Type | Description |
|---|---|---|
| status? | string | Filter by status |
| type? | string | Filter by type |
| assignee? | string | Filter by assignee |
| limit? | number | Maximum issues to return |
| Argument | Type | Description |
|---|---|---|
| q | string | bd query language expression, e.g. "status=open AND type=bug" or "priority<=1 AND label=swarm". Comparisons use =, !=, <, <=, >, >= with AND/OR/NOT and parentheses; bd\ |
| limit? | number | Maximum issues to return |
| includeClosed? | boolean | Include closed issues (bd excludes them by default; needed for status=closed queries) |
| sort? | enum | Sort by field (bd's default order otherwise) |
| reverse? | boolean | Reverse sort order (has no effect unless sort is set) |
| Argument | Type | Description |
|---|---|---|
| assignee? | string | Filter to issues assigned to this actor |
| limit? | number | Maximum issues to return |
| Argument | Type | Description |
|---|---|---|
| id | string | Issue ID (e.g., bd-mhw-1) |
| Argument | Type | Description |
|---|---|---|
| title | string | Issue title |
| description? | string | Issue description |
| type? | string | Issue type (bug|feature|task|epic|chore|decision) |
| priority? | number | Priority (0-4, 0=highest) |
| labels? | array | Labels |
| assignee? | string | Assignee |
| due? | string | Due date |
| externalRef? | string | External reference |
| parentId? | string | Parent issue ID |
| Argument | Type | Description |
|---|---|---|
| id | string | Issue ID (e.g., bd-mhw-1) |
| title? | string | New title |
| description? | string | New description |
| status? | string | New status (open|in_progress|blocked|closed|deferred) |
| priority? | number | New priority (0-4, 0=highest) |
| assignee? | string | New assignee |
| claim? | boolean | Atomically claim the issue (sets assignee to you, status to in_progress) |
| addLabels? | array | Labels to add |
| removeLabels? | array | Labels to remove |
| Argument | Type | Description |
|---|---|---|
| id | string | Issue ID (e.g., bd-mhw-1) |
| reason? | string | Closure reason |
| Argument | Type | Description |
|---|---|---|
| ids | array | Issue IDs to reopen |
| reason? | string | Reason for reopening |
| Argument | Type | Description |
|---|---|---|
| action? | enum | Dependency action: add makes issueId depend on dependsOnId, remove unlinks them, list returns the dependency issues |
| issueId | string | Issue ID (e.g., bd-mhw-1); for add/remove the side that depends on dependsOnId |
| dependsOnId? | string | The issue that issueId depends on (required for add/remove) |
| direction? | enum | List direction: down = what issueId depends on, up = what depends on issueId (list only) |
| Argument | Type | Description |
|---|---|---|
| ids? | array | Only reclaim these issue IDs |
| maxAge? | string | Grace window past lease expiry, e.g. 10m or 1h; defaults to bd's own (10m) |
| Argument | Type | Description |
|---|---|---|
| rootId? | string | Anchor the graph at this issue; omit to graph all open issues |
| direction? | enum | downstream = what the root depends on, upstream = what depends on the root (requires rootId), both = the union |
| depth? | number | Maximum hops from rootId to include (-1 = unlimited; ignored when rootId is omitted) |
| Argument | Type | Description |
|---|---|---|
| memories? | enum | Persistent-memory section: include (default), only (that section alone), or exclude (omit it) |
| maxMemories? | number | Cap the number of injected memories (0 = unlimited); whole memories only |
| maxMemoryChars? | number | Cap the total bytes of injected memories (0 = unlimited); whole memories only |
Resources
Modified 1 behaviors
Relicense from AGPL-3.0-only to MIT.
Declare license: AGPL-3.0-only; also publishes the committed query/reopen/dep/reclaim/graph methods (model 2026.10.07.2) that were not in the last published build.
Modified 1 behaviors
Modified 1 behaviors
Adds four methods completing the issue-lifecycle and workflow-orchestration surface: dep (add/remove/list issue dependencies, cycle-checked, typed records), reopen (one or more closed issues with a reason; already-open is a no-op), reclaim (revert in_progress issues with stale leases to open - dead-worker recovery with optional maxAge grace window and id filter), and graph (dependency graph as structured data: nodes, typed edges, layout layers, optional rootId/direction/depth for Mermaid rendering). New dependencyGraph resource. Existing methods unchanged.
Modified 1 behaviors
Add query method: filter issues with bd's query language (comparisons =, !=, <, <=, >, >= with AND/OR/NOT and parentheses; e.g. "status=open AND type=bug"), with limit (default 50) and honest truncation flagging, includeClosed (--all, needed for status=closed queries since bd excludes closed by default), and --sort/--reverse. Read-only; emits the same normalized issue resources as list/ready. Note: bd itself does not accept colon syntax (status:open) — use field=value.
Modified 1 behaviors
Republish from maphew/swamp-extensions with honest truncation reporting.
- Issue spec gains a
truncatedboolean; list and ready set it on every returned issue when more matched thanlimitallowed - list and ready now pass
--limit <limit + 1>to bd, so the flag reflects bd's real cap instead of its own 50/100-row default (alimit: 200request previously returned 50) - Completion logs include the limit and truncation state
- New test covers both the capped and uncapped paths
- Adversarial review recorded (3 non-blocking findings: unguarded JSON.parse error context, create is not idempotent, no delete/sync by design)
Sources live at https://github.com/maphew/swamp-extensions/tree/main/extensions/bd (AGPL-3.0).
Align the model type version with the extension version (2026.10.02.2) so swamp model type describe and model instances report the published release. Adds a no-op upgrade entry for the relocation; no method or schema changes.
Package moved from maphew/myswamp to maphew/swamp-extensions (AGPL-3.0).
- Source of truth is now https://github.com/maphew/swamp-extensions under extensions/bd/
- Relicensed from MIT to AGPL-3.0 to match the hosting repository
- Model behaviour unchanged: list, ready, show, create, update, close
Modified 1 behaviors
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License2/2earned
- Verified public repository2/2earned
Spawns a subprocess with Deno.Command().
- models/src/bd_project.ts:317 — the bd CLI is the contract this extension wraps; args are a validated argv array (no shell).