blz-source-management

name	blz-source-management
description	Teaches how to discover, validate, and add llms.txt documentation sources to the blz CLI. Use when adding documentation to blz, finding llms.txt or llms-full.txt files, validating sources, refreshing content, or managing the documentation index. Covers source discovery, dry-run validation, and index file handling.

BLZ Source Management

Add and manage llms.txt documentation sources for local search.

Source Types

Type	Description	Action
llms-full.txt	Complete documentation (preferred)	Add directly
llms.txt (full)	Complete docs under standard name	Add directly
llms.txt (index)	Links to other docs (< 100 lines)	Expand linked files

Adding Sources

Standard Workflow

# 1. Dry-run to validate
blz add react https://react.dev/llms.txt --dry-run --quiet

# 2. Check output
# Good: contentType: "full", lineCount > 1000
# Index: contentType: "index", lineCount < 100 → find linked docs

# 3. Add if good
blz add react https://react.dev/llms.txt -y

# 4. Verify
blz list --json | jq '.[] | select(.alias=="react")'

Discovering URLs

Web search patterns:

"llms-full.txt" site:docs.example.com
"llms.txt" OR "llms-full.txt" <library-name>
site:github.com/org/repo "llms.txt"

Common URL patterns: