smolbren: local search for your Markdown vaults

Welcome to smolbren — an ontology-first search CLI for Markdown vaults. It turns your frontmatter into a typed knowledge graph, layers BM25 full-text search on top, and exposes everything through single-line JSON output that agents and scripts can consume directly. No server, no cloud, no configuration sprawl — just your notes and a fast local index.

Introduction

Understand what smolbren does, how its core concepts fit together, and which workflows it’s built for.

Quickstart

Install smolbren, register your vault, build the index, and run your first search in under five minutes.

Ontology

Learn how frontmatter type keys and wikilink-valued fields become graph node labels and typed edges.

CLI Reference

Full reference for every smolbren subcommand, flag, and exit code.

Get started in three steps

Install smolbren

Install the pre-built binary with Homebrew:

brew install junaidrahim/tap/smolbren

Point smolbren at your Markdown directory. The first vault you add automatically becomes the default:

smolbren vault add personal ~/notes --default

Index and search

Build the index (incremental by default — only changed files are re-read), then start querying:

smolbren index
smolbren search "context engineering"
smolbren query "MATCH (n:blog) RETURN n.title LIMIT 5"

Get Started

Core Concepts

Guides

Configuration

smolbren: local search for your Markdown vaults

Introduction

Quickstart

Ontology

CLI Reference

Get started in three steps

Introduction

Quickstart

Ontology

CLI Reference

​Get started in three steps

Get started in three steps