Skip to content

v8.9.0

Latest

Choose a tag to compare

@sysid sysid released this 18 Nov 19:32

Highlights

Two commands that duplicated others are gone, and every hsearch hit now says how it was found, so loosely related results are easy to spot.

Breaking Changes

  • bkmr sem-search is removed. Use bkmr hsearch --mode semantic QUERY. It runs the same vector search and adds what sem-search lacked: tag filters, --json, --fzf and --stdout.
  • bkmr clear-embeddings is removed. Use bkmr backfill --clear. It still asks first (exit 130 if declined) and needs no embedding model. It cannot be combined with --force, --prune or --dry-run.
  • Piped hsearch output changes shape. It now always has six tab-separated columns: id, title, url, rrf_score, similarity and keyword_match. The last two are empty where they do not apply. In title and url, backslash, tab, newline and carriage return are written as \\, \t, \n and \r, so multi-line snippet and markdown content stays on one line. Scripts that read the url column as raw content must unescape it.

New

  • hsearch --mode semantic returns only the bookmarks closest in meaning, ranked by similarity.
  • Every hit reports similarity (cosine similarity to the query, 1 = same meaning) and keyword_match (whether the keyword search found it). Both are new --json keys, left out where they do not apply, and the interactive list shows them as [kw] and sim 0.812. Semantic search has no cutoff, so a hit with keyword_match: false and a low similarity is only loosely related.

Behaviour changes

  • After switching the embedding model, hsearch fails with a message that names the fix, bkmr backfill --force, instead of sqlite-vec's raw dimension error.
  • hsearch --mode semantic without stored embeddings suggests running bkmr backfill.
  • The hsearch open prompt rejects IDs that are not numbers or not among the results, and opens nothing until every ID is valid. Before, such IDs were skipped silently.
  • backfill --clear resets content hashes even when no vectors are stored, so the next backfill embeds everything again.

What's Changed

  • feat(cli)!: fold sem-search into hsearch and clear-embeddings into backfill by @sysid in #104

Full Changelog: v8.8.0...v8.9.0