Skip to content

chore(search): adopt zvec-grep 0.2.2 (local semantic search; config + docs only) - #51

Merged
DealAppSeo merged 1 commit into
mainfrom
chore/claude-2026-10-13-zvec-grep
Oct 14, 2026
Merged

DealAppSeo merged 1 commit into
mainfrom
chore/claude-2026-10-13-zvec-grep

Conversation

@DealAppSeo

Copy link
Copy Markdown
Owner

What

This adopts zvec-grep (zg, Apache-2.0, pinned 0.2.2) as local semantic code search. The PR changes config and docs only:

  • .zvec-grep-ignore (new): index exclusions (reports/, node_modules/, dist/, build/, coverage/, .next/, logs, jsonl/csv/map, lockfile). .git/ and .zvec-grep/ are always excluded.
  • .gitignore: adds .zvec-grep/ (the local index).
  • .mcp.json: adds a zvec-grep stdio entry, zg server --stdio --mcp-toolset agent. It is search-only. It starts or reuses the shared daemon on 127.0.0.1:7999 (loopback only).
  • package.json: adds search:index (zg index . --embedding local/potion-retrieval-32m --ignore-file .zvec-grep-ignore). The index is incremental, so re-run it after big changes.
  • CLAUDE.md: a short section saying "For 'where/how is X handled' questions use zg first; for exact identifiers use rg; only open files zg or rg points to."

Rules held

  • Free and local only. The embedding model is local/potion-retrieval-32m (125 MB, downloaded once). Remote embedding needs an explicit --allow-remote, and nothing here passes it.
  • No secrets, no README/hero/landing changes, no stake flags, no prod SQL, no code changes.
  • zg install was not run (that edits the global ~/.claude config). The MCP wiring is per project only.

Known limits

  • Any machine or cloud session without zg installed (npm i -g @zvec/zvec-grep@0.2.2, Node >= 22) shows this MCP server as failed to start. That's harmless, and rg still works.
  • The index is per checkout. A fresh worktree has no index until npm run search:index is run there.

Draft. Do not merge without review.

🤖 Generated with Claude Code

…g + docs only)

Local model local/potion-retrieval-32m only; search-only MCP entry; index gitignored.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@DealAppSeo
DealAppSeo force-pushed the chore/claude-2026-10-13-zvec-grep branch from d0e9872 to 255d927 Compare October 14, 2026 22:13
@DealAppSeo
DealAppSeo marked this pull request as ready for review October 14, 2026 22:21
@strix-security

strix-security Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

Strix Security Review

No security issues found.

Review summary

Reviewed the config-and-docs-only PR adopting zvec-grep (zg) 0.2.2 for local semantic search. All five changed files (.gitignore, .mcp.json, .zvec-grep-ignore, CLAUDE.md, package.json) were examined. The MCP server entry uses the default agent toolset, which upstream documentation confirms exposes only the indexed zvec_grep_search tool — not the full toolset (index/rg/drop/status), and remote embedding requires a separate explicit authorization that is not passed. The index is built with a local-only embedding model, is gitignored, excludes gitignored paths by default, and no committed secrets were found to be at risk. The loopback-only daemon and pinned version are consistent with the PR's stated "free and local only" intent. No security vulnerabilities were introduced by this change.

Updated for 255d927.


Reviewed by Strix
Re-run review · Configure security review settings

@DealAppSeo
DealAppSeo merged commit db4029b into main Oct 14, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant