136 lines
7.1 KiB
Text
136 lines
7.1 KiB
Text
Issues chained together like beads. A lightweight issue tracker with first-class dependency support.
|
|
|
|
Usage:
|
|
bd [flags]
|
|
bd [command]
|
|
|
|
Maintenance:
|
|
rename-prefix Rename the issue prefix for all issues in the database
|
|
repair Repair corrupted database by cleaning orphaned references
|
|
resolve-conflicts Resolve git merge conflicts in JSONL files
|
|
|
|
Integrations & Advanced:
|
|
Working With Issues:
|
|
children List child beads of a parent
|
|
close Close one or more issues
|
|
comments View or manage comments on an issue
|
|
create Create a new issue (or multiple issues from markdown file)
|
|
create-form Create a new issue using an interactive form
|
|
delete Delete one or more issues and clean up references
|
|
edit Edit an issue field in $EDITOR
|
|
gate Manage async coordination gates
|
|
label Manage issue labels
|
|
list List issues
|
|
merge-slot Manage merge-slot gates for serialized conflict resolution
|
|
move Move an issue to a different rig with dependency remapping
|
|
promote Promote a wisp to a permanent bead
|
|
q Quick capture: create issue and output only ID
|
|
query Query issues using a simple query language
|
|
refile Move an issue to a different rig
|
|
reopen Reopen one or more closed issues
|
|
search Search issues by text query
|
|
set-state Set operational state (creates event + updates label)
|
|
show Show issue details
|
|
state Query the current value of a state dimension
|
|
todo Manage TODO items (convenience wrapper for task issues)
|
|
update Update one or more issues
|
|
|
|
Views & Reports:
|
|
activity Show real-time molecule state feed
|
|
count Count issues matching filters
|
|
diff Show changes between two commits or branches (requires Dolt backend)
|
|
find-duplicates Find semantically similar issues using text analysis or AI
|
|
history Show version history for an issue (requires Dolt backend)
|
|
lint Check issues for missing template sections
|
|
stale Show stale issues (not updated recently)
|
|
status Show issue database overview and statistics
|
|
types List valid issue types
|
|
|
|
Dependencies & Structure:
|
|
dep Manage dependencies
|
|
duplicate Mark an issue as a duplicate of another
|
|
duplicates Find and optionally merge duplicate issues
|
|
epic Epic management commands
|
|
graph Display issue dependency graph
|
|
supersede Mark an issue as superseded by a newer one
|
|
swarm Swarm management for structured epics
|
|
|
|
Sync & Data:
|
|
branch List or create branches (requires Dolt backend)
|
|
daemon Manage background sync daemon
|
|
export Export issues to JSONL or Obsidian format
|
|
federation Manage peer-to-peer federation (requires CGO)
|
|
import Import issues from JSONL format
|
|
merge Git merge driver for beads JSONL files
|
|
restore Restore full history of a compacted issue from git
|
|
sync Export database to JSONL (sync with git)
|
|
vc Version control operations (requires Dolt backend)
|
|
|
|
Setup & Configuration:
|
|
backend Manage storage backend configuration
|
|
config Manage configuration settings
|
|
hooks Manage git hooks for bd auto-sync
|
|
human Show essential commands for human users
|
|
info Show database and daemon information
|
|
init Initialize bd in the current directory
|
|
kv Key-value store commands
|
|
onboard Display minimal snippet for AGENTS.md
|
|
prime Output AI-optimized workflow context
|
|
quickstart Quick start guide for bd
|
|
setup Setup integration with AI editors
|
|
where Show active beads location
|
|
|
|
Maintenance:
|
|
doctor Check and fix beads installation health (start here)
|
|
migrate Database migration commands
|
|
preflight Show PR readiness checklist
|
|
upgrade Check and manage bd version upgrades
|
|
worktree Manage git worktrees for parallel development
|
|
|
|
Integrations & Advanced:
|
|
admin Administrative commands for database maintenance
|
|
jira Jira integration commands
|
|
linear Linear integration commands
|
|
repo Manage multiple repository configuration
|
|
|
|
Additional Commands:
|
|
agent Manage agent bead state
|
|
audit Record and label agent interactions (append-only JSONL)
|
|
blocked Show blocked issues
|
|
completion Generate the autocompletion script for the specified shell
|
|
cook Compile a formula into a proto (ephemeral by default)
|
|
defer Defer one or more issues for later
|
|
formula Manage workflow formulas
|
|
gitlab GitLab integration commands
|
|
help Help about any command
|
|
hook Execute a git hook (called by hook scripts)
|
|
mail Delegate to mail provider (e.g., gt mail)
|
|
mol Molecule commands (work templates)
|
|
orphans Identify orphaned issues (referenced in commits but still open)
|
|
ready Show ready work (open, no blockers)
|
|
rename Rename an issue ID
|
|
ship Publish a capability for cross-project dependencies
|
|
slot Manage agent bead slots
|
|
undefer Undefer one or more issues (restore to open)
|
|
version Print version information
|
|
|
|
Flags:
|
|
--actor string Actor name for audit trail (default: $BD_ACTOR, git user.name, $USER)
|
|
--allow-stale Allow operations on potentially stale data (skip staleness check)
|
|
--db string Database path (default: auto-discover .beads/*.db)
|
|
--dolt-auto-commit string Dolt backend: auto-commit after write commands (off|on). Default from config key dolt.auto-commit
|
|
-h, --help help for bd
|
|
--json Output in JSON format
|
|
--lock-timeout duration SQLite busy timeout (0 = fail immediately if locked) (default 30s)
|
|
--no-auto-flush Disable automatic JSONL sync after CRUD operations
|
|
--no-auto-import Disable automatic JSONL import when newer than DB
|
|
--no-daemon Force direct storage mode, bypass daemon if running
|
|
--no-db Use no-db mode: load from JSONL, no SQLite
|
|
--profile Generate CPU profile for performance analysis
|
|
-q, --quiet Suppress non-essential output (errors only)
|
|
--readonly Read-only mode: block write operations (for worker sandboxes)
|
|
--sandbox Sandbox mode: disables daemon and auto-sync
|
|
-v, --verbose Enable verbose/debug output
|
|
-V, --version Print version information
|
|
|
|
Use "bd [command] --help" for more information about a command.
|