lb search

Synopsis

lb search [query] [options]

Description

lb search queries your knowledge graph and returns matching nodes. When no query is provided, results are returned in recency order. Use filters to narrow by PARA tag, status, or free-form tags.

Options

Option	Type	Default	Description
--para <id>	string	—	Filter to nodes tagged with this PARA item ID.
--status <status>	string	—	Filter by node status (active, archived).
--tags <tags>	string	—	Comma-separated tag names to filter by.
--limit <n>	number	20	Maximum number of results to return.
--page <n>	number	1	Page number for pagination.
--mode <mode>	string	hybrid	Search mode: keyword, semantic, or hybrid.
--json	flag	—	Output raw JSON.
--api-url <url>	string	—	Override the API base URL.

Search modes

Mode	Description
keyword	Full-text search using SQLite FTS5. Exact and prefix matches. Fast, no vector index required.
semantic	Vector similarity search using embeddings. Finds conceptually related content even when keywords differ.
hybrid	Reciprocal Rank Fusion of keyword and semantic results. Best recall for most queries. Default.

Examples

Full-text search:

lb search "authentication flow"

Semantic search for related concepts:

lb search "how tokens expire" --mode semantic

Filter by PARA item:

lb search "API design" --para proj_abc123

Paginate through results:

lb search "database" --limit 10 --page 2

Filter by status and output as JSON:

lb search --status active --json | jq '.[].title'

Combine filters:

lb search "observability" --tags monitoring,tracing --limit 5