How It Works

Search

How search works

Gearbox Relay uses two complementary search systems. Full-text search (SQLite FTS5) indexes all capture text, summaries, and tags for keyword matching. Semantic search (LanceDB) stores embedding vectors that let you find captures by meaning.

Search interface

Desktop

Press Ctrl+K (or Cmd+K on macOS) to open the search palette from anywhere in the app. Start typing to see results immediately.

Mobile

Tap the search bar at the top of the screen. Results appear as you type.

Search operators

You can use several operators to refine your searches.

Keyword search finds captures containing specific words. Phrase search (using quotes) finds exact phrases. Prefix matching (using asterisks) finds words starting with a prefix. Tag filtering (using tag:) finds captures with specific tags.

Semantic search finds captures by meaning rather than exact words. Open the search palette, type a natural language query, and results are ranked by semantic similarity to your query. This is useful when you remember the gist but not the exact words.

Filters

Filter search results by date range, tags, capture source (clipboard, extension, share, manual paste), or Stream membership.

Search tips

Be specific when searching. Use semantic search for exploration when you are not sure what you are looking for. Combine filters for precise results. Tag names are indexed, so searching tag:project-x finds all captures with that tag.

Performance

Full-text search responds in under 50ms. Semantic search adds 10-30ms. Libraries with thousands of captures maintain sub-100ms search latency.

Limitations

Captures are indexed for full-text and semantic search, but some metadata (exact capture time, source app) is not keyword-searchable. Deleted captures are removed from the index immediately.

Previous
Captures