Beads Tracker (bd) gate
106 allow
114 ask
0 block
Beads git-native issue tracker. Reads are safe; writes ask. Nothing is hard-blocked because every beads state mutation is recoverable through git or remote sync. Two warn = true rules: bd admin reset and bd reset drop the local database.
Showing all 220 rules.
Allowed · queries
rules/beads.toml#allow 106 patternsbd list
Allow
Lists issues, optionally filtered by status, priority, type, or assignee. Read-only.
bd show
Allow
Shows full details of one issue: description, status, dependencies, and history. Read-only.
bd ready
Allow
Lists issues ready to work on (all dependencies satisfied). Read-only.
bd blocked
Allow
Lists issues blocked by unmet dependencies. Read-only.
bd count
Allow
Prints the number of issues matching a filter. Read-only.
bd search
Allow
Full-text search across issue titles and descriptions. Read-only.
bd where
Allow
Prints the path to the active beads database and workspace. Read-only.
bd info
Allow
Shows workspace metadata: database location, issue prefix, and counts. Read-only.
bd version
Allow
Prints the bd version string. Read-only.
bd help
Allow
Prints command help text. Read-only.
bd status
Allow
Shows workspace status: pending sync, daemon state, and issue counts. Read-only.
bd doctor
Allow
Runs diagnostic checks on the workspace and reports problems. Read-only.
bd lint
Allow
Checks issues for consistency problems and reports findings. Read-only.
bd human
Allow
Prints issues in a human-readable summary format. Read-only.
bd onboard
Allow
Prints onboarding guidance for getting started with beads. Read-only.
bd completion
Allow
Prints a shell completion script to stdout. Read-only.
bd thanks
Allow
Prints project credits. Read-only.
bd detect-pollution
Allow
Scans for cross-workspace data pollution and reports findings. Read-only.
bd dep
Allow
Inspects issue dependencies. Read-only unless
add or remove is given, which edit edges and ask separately.bd dep tree
Allow
Displays the dependency tree for an issue. Read-only.
bd dep cycles
Allow
Detects and reports dependency cycles in the issue graph. Read-only.
bd graph
Allow
Renders the issue dependency graph. Read-only.
bd label
Allow
Inspects issue labels. Read-only unless
add or remove is given, which mutate labels and ask separately.bd label list
Allow
Lists labels in use. Read-only.
bd label list-all
Allow
Lists all defined labels, including unused ones. Read-only.
bd comments
Allow
Shows comments on an issue. Read-only unless
add is given, which posts a comment and asks separately.bd comment
Allow
Shows comments on an issue. Read-only unless
add is given, which posts a comment and asks separately.bd daemons
Allow
Reports daemon status. Read-only unless a control verb (
start, stop, restart, killall) is given, which asks separately.bd daemons list
Allow
Lists running beads daemons. Read-only.
bd daemons health
Allow
Reports health of running daemons. Read-only.
bd daemons logs
Allow
Prints daemon log output. Read-only.
bd daemon
Allow
Reports daemon status. Read-only unless a control verb (
start, stop, restart, kill, run) is given, which asks separately.bd daemon health
Allow
Reports health of the daemon. Read-only.
bd daemon logs
Allow
Prints daemon log output. Read-only.
bd config
Allow
Reads configuration. Read-only unless
set or unset is given, which write config and ask separately.bd config get
Allow
Prints a single configuration value. Read-only.
bd config list
Allow
Prints all configuration values. Read-only.
bd stats
Allow
Shows aggregate issue counts by status, priority, and type. Read-only.
bd activity
Allow
Shows recent issue activity. Read-only.
bd stale
Allow
Lists issues with no recent activity. Read-only.
bd orphans
Allow
Lists orphaned issues with no parent or links. Read-only.
bd preflight
Allow
Runs preflight checks and reports readiness. Read-only.
bd audit
Allow
Shows the audit log. Read-only unless
record or label is given, which write audit entries and ask separately.bd epic
Allow
Inspects epics. Read-only unless
create, close, or update is given, which mutate epics and ask separately.bd epic status
Allow
Shows epic progress and child-issue rollup. Read-only.
bd close-eligible
Allow
Lists issues eligible to be closed. Read-only.
bd swarm
Allow
Inspects swarms. Read-only unless a mutating verb (
create, close, update, add, remove) is given, which asks separately.bd swarm list
Allow
Lists swarms. Read-only.
bd gate
Allow
Inspects gates. Read-only unless
resolve or add-waiter is given, which mutate gate state and ask separately.bd gate list
Allow
Lists gates. Read-only.
bd gate show
Allow
Shows details of one gate. Read-only.
bd gate check
Allow
Checks whether a gate's conditions are met. Read-only.
bd gate discover
Allow
Discovers gates from the workspace and reports them. Read-only.
bd template
Allow
Inspects templates. Read-only unless
instantiate is given, which creates issues and asks separately.bd template list
Allow
Lists available templates. Read-only.
bd template show
Allow
Shows the contents of one template. Read-only.
bd formula
Allow
Inspects formulas. Read-only unless a mutating verb (
create, delete, update, edit, convert) is given, which asks separately.bd formula list
Allow
Lists available formulas. Read-only.
bd formula show
Allow
Shows the contents of one formula. Read-only.
bd mol
Allow
Inspects molecules. Read-only unless a mutating verb (
burn, squash, bond, distill, create) is given, which asks separately.bd mol show
Allow
Shows details of one molecule. Read-only.
bd mol current
Allow
Shows the currently active molecule. Read-only.
bd mol stale
Allow
Lists molecules with no recent activity. Read-only.
bd mol progress
Allow
Shows progress of a molecule's issues. Read-only.
bd mol list
Allow
Lists molecules. Read-only.
bd slot
Allow
Inspects slots. Read-only unless a mutating verb (
set, clear, claim, release) is given, which asks separately.bd slot show
Allow
Shows details of one slot. Read-only.
bd slot list
Allow
Lists slots. Read-only.
bd agent
Allow
Inspects agents. Read-only unless a mutating verb (
set, clear, update, create) is given, which asks separately.bd agent show
Allow
Shows details of one agent. Read-only.
bd agent list
Allow
Lists agents. Read-only.
bd state
Allow
Inspects workflow states. Read-only.
bd state list
Allow
Lists configured workflow states. Read-only.
bd worktree
Allow
Inspects worktrees. Read-only unless
add, remove, or prune is given, which mutate worktrees and ask separately.bd worktree list
Allow
Lists worktrees. Read-only.
bd repo
Allow
Inspects linked repositories. Read-only unless a mutating verb (
add, remove, set, sync) is given, which asks separately.bd repo list
Allow
Lists linked repositories. Read-only.
bd repo show
Allow
Shows details of one linked repository. Read-only.
bd jira
Allow
Inspects the Jira integration. Read-only unless a data-flow verb (
sync, push, import, create) is given, which asks separately.bd jira status
Allow
Shows Jira integration status. Read-only.
bd jira list
Allow
Lists Jira issues visible to the integration. Read-only.
bd jira show
Allow
Shows one Jira issue. Read-only.
bd linear
Allow
Inspects the Linear integration. Read-only unless a data-flow verb (
sync, push, import, create) is given, which asks separately.bd linear status
Allow
Shows Linear integration status. Read-only.
bd linear list
Allow
Lists Linear issues visible to the integration. Read-only.
bd linear show
Allow
Shows one Linear issue. Read-only.
bd ship
Allow
Inspects ships. Read-only unless
publish, create, or delete is given, which mutate ships and ask separately.bd ship list
Allow
Lists ships. Read-only.
bd ship show
Allow
Shows details of one ship. Read-only.
bd upgrade
Allow
Reports available upgrades. Read-only unless
--apply, --install, or ack is given, which change state and ask separately.bd upgrade status
Allow
Shows current upgrade status. Read-only.
bd upgrade review
Allow
Shows what an upgrade would change before applying it. Read-only.
bd migrate
Allow
Previews a database migration. Read-only unless
--apply or --force is given, which writes the migration and asks separately.bd duplicates
Allow
Lists suspected duplicate issues. Read-only unless
--auto-merge is given, which merges them and asks separately.bd cleanup --dry-run
Allow
Previews cleanup of stale or orphaned issues. Read-only because
--dry-run reports what would be removed without writing.bd compact --dry-run
Allow
Previews database compaction. Read-only because
--dry-run reports what would change without writing.bd delete --dry-run
Allow
Previews an issue deletion. Read-only because
--dry-run reports what would be deleted without writing.bd admin cleanup --dry-run
Allow
Previews admin-level cleanup. Read-only because
--dry-run reports what would be removed without writing.bd admin compact --dry-run
Allow
Previews admin-level compaction. Read-only because
--dry-run reports what would change without writing.bd prime
Allow
Prints a context summary to prime an AI assistant. Read-only.
bd quickstart
Allow
Prints quickstart guidance. Read-only.
bd workflow
Allow
Prints the configured workflow description. Read-only.
bd tips
Allow
Prints usage tips. Read-only.
bd deleted
Allow
Lists soft-deleted (tombstoned) issues. Read-only.
bd hook
Allow
Inspects configured hooks. Read-only.
bd pin
Allow
Shows the pinned issue for an agent. Read-only unless
--set or --clear is given, which change the pin and ask separately.Asks first · mutations
rules/beads.toml#ask 114 patternsbd create
Ask
Creating new issue
bd create-form
Ask
Creating issue via form
bd q
Ask
Quick capturing issue
bd quick
Ask
Quick capturing issue
bd update
Ask
Updating issue
bd edit
Ask
Editing issue in editor
bd close
Ask
Closing issue
bd reopen
Ask
Reopening issue
bd delete
Ask
Deleting issue
bd move
Ask
Moves an issue to a different rig (workspace). Changes the issue's owning database; sync source and target to keep both consistent.
bd refile
Ask
Refiling issue
bd set-state
Ask
Setting issue state
bd defer
Ask
Deferring issue
bd undefer
Ask
Undeferring issue
bd dep add
Ask
Adding dependency
bd dep remove
Ask
Removing dependency
bd relate
Ask
Relating issues
bd unrelate
Ask
Unrelating issues
bd duplicate
Ask
Marking as duplicate
bd supersede
Ask
Marking as superseded
bd label add
Ask
Adding label
bd label remove
Ask
Removing label
bd comments add
Ask
Adding comment
bd comment add
Ask
Adding comment
bd sync
Ask
Syncs local issues with the git-backed remote. Pulls and pushes issue changes; may merge or overwrite local edits if the remote diverged.
bd export
Ask
Exporting issues
bd import
Ask
Importing issues
bd init
Ask
Initializing beads in project
bd setup
Ask
Setting up integration
bd config set
Ask
Changing configuration
bd config unset
Ask
Unsetting configuration
bd daemons start
Ask
Starts a beads daemon process in the background. Daemons handle sync, hooks, and event delivery.
bd daemons stop
Ask
Stops a running beads daemon process. Pauses background sync, hooks, and event delivery until restarted.
bd daemons restart
Ask
Restarts a beads daemon process. Briefly pauses background sync, hooks, and event delivery.
bd daemons killall
Ask
Kills every running beads daemon process on this machine. Stops background sync, hooks, and event delivery until restarted.
bd daemon start
Ask
Starts a beads daemon process in the background. Daemons handle sync, hooks, and event delivery.
bd daemon stop
Ask
Stops a running beads daemon process. Pauses background sync, hooks, and event delivery until restarted.
bd daemon restart
Ask
Restarts a beads daemon process. Briefly pauses background sync, hooks, and event delivery.
bd daemon kill
Ask
Force-kills a beads daemon process. May leave temporary state if the daemon was mid-write.
bd daemon run
Ask
Runs a beads daemon in the foreground. Holds the terminal until interrupted.
bd hooks
Ask
Managing git hooks
bd migrate --apply --force
Ask
Migrating database
bd migrate sync
Ask
Migrating sync
bd migrate issues
Ask
Migrating issues
bd migrate hash-ids
Ask
Migrating hash IDs
bd migrate tombstones
Ask
Migrating tombstones
bd admin
Ask
Runs a beads admin operation (cleanup, compact, or reset depending on the subcommand). Scope varies;
admin reset is destructive.bd admin cleanup
Ask
Admin-level cleanup of stale or orphaned issues. Removes records matching cleanup rules; preview first with
--dry-run. Recoverable via git.bd admin compact
Ask
Admin-level compaction to shrink the database. Condenses resolved issue history; preview first with
--dry-run. Recoverable via git.bd admin reset
Askwarn
Resets the beads database. Drops all issues, history, and local state. Cannot be undone without a backup or remote sync.
bd compact
Ask
Compacts old issues to shrink the database. Condenses or removes resolved history; preview first with
--dry-run. Recoverable via git.bd cleanup
Ask
Cleans up stale or orphaned issues. Removes records that match cleanup rules; preview first with
--dry-run. Recoverable via git.bd merge
Ask
Merges two issues into one. Combines their fields and history and tombstones the merged-away issue. Recoverable via git history.
bd duplicates --auto-merge
Ask
Auto-merging duplicates
bd repair
Ask
Repairs the beads database from local logs and remote state. Can modify or roll back issue records to resolve inconsistencies.
bd restore
Ask
Restores a soft-deleted (tombstoned) issue back to active state.
bd upgrade ack
Ask
Acknowledging upgrade
bd upgrade --apply --install
Ask
Applying upgrade
bd epic create
Ask
Creating epic
bd epic close
Ask
Closing epic
bd epic update
Ask
Updating epic
bd swarm create
Ask
Creating swarm
bd swarm close
Ask
Closing swarm
bd swarm update
Ask
Updating swarm
bd swarm add
Ask
Adding to swarm
bd swarm remove
Ask
Removing from swarm
bd gate resolve
Ask
Resolving gate
bd gate add-waiter
Ask
Adding gate waiter
bd template instantiate
Ask
Instantiating template
bd mol burn
Ask
Burning molecule
bd mol squash
Ask
Squashing molecule
bd mol bond
Ask
Bonding molecules
bd mol distill
Ask
Distilling molecule
bd mol create
Ask
Creating molecule
bd pour
Ask
Creating molecule from formula
bd wisp
Ask
Creating ephemeral wisp
bd cook
Ask
Compiling formula to proto
bd formula create
Ask
Creating formula
bd formula delete
Ask
Deleting formula
bd formula update
Ask
Updating formula
bd formula edit
Ask
Editing formula
bd formula convert
Ask
Converting formula
bd slot set
Ask
Setting slot
bd slot clear
Ask
Clearing slot
bd slot claim
Ask
Claiming slot
bd slot release
Ask
Releasing slot
bd agent set
Ask
Setting agent state
bd agent clear
Ask
Clearing agent state
bd agent update
Ask
Updating agent
bd agent create
Ask
Creating agent
bd audit record
Ask
Recording audit entry
bd audit label
Ask
Labeling audit entry
bd pin --set --clear
Ask
Pinning work to agent
bd ship publish
Ask
Publishing capability
bd ship create
Ask
Creating ship
bd ship delete
Ask
Deleting ship
bd rename-prefix
Ask
Renames the workspace issue-ID prefix. Rewrites the ID of every issue; update any external references that pin the old prefix.
bd worktree add
Ask
Adding worktree
bd worktree remove
Ask
Removing worktree
bd worktree prune
Ask
Pruning worktrees
bd repo add
Ask
Adding repository
bd repo remove
Ask
Removing repository
bd repo set
Ask
Setting repository config
bd repo sync
Ask
Syncing repository
bd jira sync
Ask
Syncing with Jira
bd jira push
Ask
Pushing to Jira
bd jira import
Ask
Importing from Jira
bd jira create
Ask
Creating in Jira
bd linear sync
Ask
Syncing with Linear
bd linear push
Ask
Pushing to Linear
bd linear import
Ask
Importing from Linear
bd linear create
Ask
Creating in Linear
bd mail
Ask
Delegating to mail provider
bd reset
Askwarn
Resets the beads database. Drops all issues, history, and local state. Cannot be undone without a backup or remote sync.