bwrb bulk
Perform batch operations on multiple notes with targeting and safety gates.
Synopsis
Section titled “Synopsis”bwrb bulk [options] [target]The target argument is auto-detected as type, path (contains /), or where expression.
Options
Section titled “Options”Targeting
Section titled “Targeting”| Option | Description |
|---|---|
-t, --type <type> | Filter by type |
-p, --path <glob> | Filter by file path (supports globs) |
-w, --where <expr> | Filter by frontmatter expression (repeatable, ANDed) |
-b, --body <query> | Filter by Markdown body content; YAML frontmatter is excluded |
-a, --all | Target all files (requires explicit intent) |
Operations
Section titled “Operations”| Option | Description |
|---|---|
--set <field>=<value> | Set field value (or clear with --set field=) |
--rename <old>=<new> | Rename field |
--delete <field> | Delete field |
--append <field>=<value> | Append to list field |
--remove <field>=<value> | Remove from list field |
--move <path> | Move files to path (auto-updates wikilinks) |
Execution
Section titled “Execution”| Option | Description |
|---|---|
-x, --execute | Actually apply changes (dry-run by default) |
-f, --force | Skip confirmation prompt for large/cross-type operations |
-y, --yes | Alias for --force (skip confirmation) |
--backup | Create backup before changes |
--limit <n> | Limit to n files |
Output
Section titled “Output”| Option | Description |
|---|---|
--verbose | Show detailed changes per file |
--quiet | Only show summary |
--output <format> | Output format: text, json |
In JSON mode, bulk output reports both discovery stages:
candidateFiles: files selected by type/path/body targeting before--wherematchedFiles/totalFiles: files remaining after all filtersfilesModified: files that would change or did change
Safety: Two-Gate Model
Section titled “Safety: Two-Gate Model”Bulk operations require two explicit gates to prevent accidents:
- Targeting gate: Specify selectors (
--type,--path,--where,--body) OR use--all - Execution gate: Use
--executeto apply changes (dry-run by default)
# Error: no targeting specifiedbwrb bulk --set status=settled# "No files selected. Use --type, --path, --where, --body, or --all."
# Dry-run: shows what would changebwrb bulk --type task --set status=settled
# Actually applies changesbwrb bulk --type task --set status=settled --executeWhen a change enters a trait-configured guarded transition, bulk evaluates the
same relation requirements as edit. Each blocked file is reported as an error
and remains unchanged; dry-runs report the block too.
Bulk also validates and applies entered transition_effects with the same
source-and-target lock and byte checks as edit. A target effect is direct and
non-cascading; dry-runs surface invalid target patches before reporting a change.
Non-interactive Confirmation
Section titled “Non-interactive Confirmation”If stdin is not a TTY and the operation requires confirmation (cross-type --all or large operations), bwrb does not prompt. Use --force/--yes to skip the confirmation or pipe a single y/yes or n/no answer. Otherwise the command fails fast with a clear error.
Examples
Section titled “Examples”Set Operations
Section titled “Set Operations”# Set field on matching notesbwrb bulk --type task --where "status == 'in-flight'" --set status=settled --execute
# Clear a fieldbwrb bulk --type task --set old_field= --execute
# Set multiple fieldsbwrb bulk --type task --where "status == 'settled'" --set archived=true --set "archived-date=2025-01-15" --executeField Management
Section titled “Field Management”# Rename a fieldbwrb bulk --all --rename old-field=new-field --execute
# Delete a fieldbwrb bulk --type task --delete legacy_field --executeList Field Operations
Section titled “List Field Operations”# Append to a list fieldbwrb bulk --type task --where "priority == 'high'" --append tags=urgent --execute
# Remove from a list fieldbwrb bulk --type task --remove tags=deprecated --executeFile Movement
Section titled “File Movement”# Move files to archive (updates wikilinks automatically)bwrb bulk --type idea --where "status == 'settled'" --move Archive/Ideas --executeAn executed move takes the same per-note locks as edit on the notes it
writes: each moved note at its old path and at its new path inside the vault,
and every note whose links it rewrites. An edit of one of those notes waits
until the move is done. Under the locks, the move scans the vault for links
again. If a note gained a link to a moved note while the move waited, the move
locks that note too and tries again. After three tries it stops with an error,
having moved nothing.
Targeting
Section titled “Targeting”# By typebwrb bulk --type task --set status=settled --execute
# By pathbwrb bulk --path "Archive/**" --set archived=true --execute
# By contentbwrb bulk --body "TODO" --set needs-review=true --execute
# By frontmatterbwrb bulk --where "status == 'active' && priority < 3" --set urgent=true --execute
# All filesbwrb bulk --all --set reviewed=true --executeSafety Options
Section titled “Safety Options”# Create backup before changesbwrb bulk --type task --all --set status=archived --execute --backup
# Limit scopebwrb bulk --type task --set status=settled --execute --limit 10
# Preview with verbose outputbwrb bulk --type task --set status=settled --verboseMigration Workflows
Section titled “Migration Workflows”# Bulk-add type to existing files by locationbwrb bulk --path "Reflections/Daily Notes" --set type=daily-note --execute
# Find files with legacy frontmatterbwrb list --where "!isEmpty(old_field)"# Warning: 'old_field' not in schema
# Rename field across all notes of a typebwrb bulk --type task --rename old_field=new_field --executeSee Also
Section titled “See Also”- CLI Safety and Flags —
--executevs--forcesemantics - Targeting Model — Full selector reference
- bwrb audit — Validate notes
- bwrb delete — Delete notes