Skip to content

bwrb template

Manage reusable templates for note creation.

Terminal window
bwrb template <subcommand>
SubcommandDescription
listList templates
newCreate a new template
editEdit an existing template
deleteDelete a template
validateValidate templates against schema
Terminal window
# List all templates
bwrb template list
# List templates for a type
bwrb template list task
# Create a new template
bwrb template new task --name bug-report
# Edit a template
bwrb template edit task bug-report
# Validate all templates
bwrb template validate

Templates are stored in .bwrb/templates/{type}/{subtype}/{name}.md.


List templates in your vault, optionally filtered by type.

Terminal window
bwrb template list [options] [type] [name]
ArgumentDescription
typeFilter to templates for this type (e.g., task, objective/milestone)
nameShow details for a specific template
OptionDescription
-o, --output <format>Output format: text, json
Terminal window
# List all templates
bwrb template list
# List templates for a specific type
bwrb template list task
bwrb template list objective/task
# Show specific template details
bwrb template list task bug-report
# JSON output
bwrb template list --output json

Create a new template for a specific note type.

Terminal window
bwrb template new [options] [type]
ArgumentDescription
typeType to create template for (prompts if omitted)
OptionDescription
--name <name>Template name (without .md extension)
--description <desc>Template description
--json <data>Create template non-interactively from JSON
Terminal window
# Create template with prompts
bwrb template new task
# Specify name
bwrb template new task --name bug-report
# With description
bwrb template new task --name bug-report --description "Bug report with repro steps"
Terminal window
# Create from JSON
bwrb template new task --name quick --json '{"defaults": {"status": "raw"}}'
# Full template definition
bwrb template new idea --name research --json '{
"description": "Research note template",
"defaults": {"status": "raw", "priority": "medium"},
"prompt-fields": ["deadline"]
}'

Edit an existing template interactively or via JSON patch.

Terminal window
bwrb template edit [options] [type] [name]
ArgumentDescription
typeType of template to edit
nameTemplate name (shows picker if omitted)
OptionDescription
--json <data>Update template non-interactively (patch/merge semantics)
Terminal window
# Edit with picker
bwrb template edit
# Edit specific template
bwrb template edit task bug-report
bwrb template edit objective/task default
Terminal window
# Update specific fields
bwrb template edit task bug-report --json '{"defaults": {"priority": "high"}}'
# Update description
bwrb template edit idea default --json '{"description": "Updated description"}'

Delete a template from your vault.

Terminal window
bwrb template delete [options] [type] [name]
ArgumentDescription
typeType of template to delete
nameTemplate name (shows picker if omitted)
OptionDescription
-f, --forceSkip confirmation prompt
-o, --output <format>Output format: text, json
Terminal window
# Delete with confirmation
bwrb template delete task bug-report
# Delete with picker
bwrb template delete
# Skip confirmation
bwrb template delete task bug-report --force
# Scripting mode
bwrb template delete task bug-report -f -o json

Validate templates to ensure they’re compatible with the current schema.

Terminal window
bwrb template validate [options] [type]
ArgumentDescription
typeValidate templates for specific type only
OptionDescription
-o, --output <format>Output format: text, json

Checks templates for:

  • Valid template-for type reference
  • Default field values match schema types
  • Default enum values are valid
  • Prompt-fields reference existing fields
  • No references to removed schema fields
Terminal window
# Validate all templates
bwrb template validate
# Validate templates for specific type
bwrb template validate task
bwrb template validate objective/milestone
# JSON output for CI
bwrb template validate --output json
CodeMeaning
0All templates valid
1Validation errors found