bwrb

Automate structured note management in markdown vaults via CLI.

1|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/3mdistal/bwrb --skill bwrb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bwrb
Source: https://github.com/3mdistal/bwrb/tree/main/docs/skill
Command: npx skills add https://github.com/3mdistal/bwrb --skill bwrb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

bwrb provides a schema-driven approach to creating, organizing, querying, and validating notes inside markdown vaults. It reduces manual frontmatter handling and ensures consistent structure across notes.

Core Features & Use Cases

  • Create structured notes with validated frontmatter using a CLI.
  • Query, filter, and audit notes by type and field values across vaults.
  • Edit note frontmatter programmatically and generate Obsidian wikilinks.
  • Validate notes against a living schema and export JSON for automation.

Quick Start

Initialize a vault with bwrb init --yes. Then define a schema and start creating notes with bwrb new, bwrb list, and bwrb edit as needed.

Frequently Asked Questions about bwrb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage markdown vault frontmatter with a schema?

You can manage markdown vault frontmatter by initializing a vault with bwrb and defining a schema to validate, create, and edit structured notes programmatically via CLI.

Can I query and filter markdown notes by frontmatter field values?

Yes, you can query and filter markdown notes by type and specific frontmatter field values across vaults using the bwrb list command in real time.

How do I validate existing notes against a living schema in a markdown vault?

You can audit existing markdown notes against a configurable living schema using the bwrb tool to ensure frontmatter consistency and identify structural violations.

What is the best way to automate note creation with validated frontmatter?

Automating note creation with validated frontmatter is best achieved by defining a schema and using the bwrb new CLI command to generate structured markdown notes automatically.

Can I export markdown vault frontmatter to JSON for automation workflows?

Yes, you can export markdown vault frontmatter to JSON I/O using the bwrb tool, enabling downstream automation workflows and programmatic data processing.

Does bwrb work with Obsidian wikilinks when editing note frontmatter?

Yes, bwrb works with Obsidian by generating and editing wikilinks programmatically when you modify note frontmatter or create new structured markdown entries.