nrepo search

Synopsis

nrepo search <query> [options]

Description

nrepo search performs a semantic search across your ideas. The query is matched against titles, bodies, and tags using vector similarity. If the semantic index is unavailable, the CLI falls back to full-text search (FTS). Results are returned in descending order by relevance score.

Options

Flag	Type	Default	Description
--limit <n>	number	10	Maximum number of results to return.
--json	boolean	(see auth)	Output results as JSON.
--human	boolean	(see auth)	Output results as human-readable text.

Examples

Basic search

nrepo search "authentication flow"

Limit results

nrepo search "dark mode" --limit 5

JSON output for scripting

nrepo search "performance optimization" --json | jq '.[].title'

Output

Each result includes the idea ID, title, status, and a relevance score between 0 and 1.

Human-readable output:

#42  (0.92)  Add dark mode to dashboard        [exploring]
#18  (0.78)  Theme system redesign              [captured]
#7   (0.65)  CSS variable cleanup               [shipped]

JSON output returns an array of scored idea objects:

[
  {
    "id": 42,
    "title": "Add dark mode to dashboard",
    "status": "exploring",
    "score": 0.92
  }
]

Related commands

• nrepo log — list ideas with filters (non-search)
• nrepo show — view full idea details
• nrepo duplicate — find and manage duplicate ideas