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