A command-line tool for finding relevant project documents by meaning rather than exact words. It searches an indexed knowledge base, such as documentation, regulations, and business-process notes.

Use it to locate related documentation, regulations, process descriptions, or context before changing project configuration; use ordinary grep for code and configuration files.

A normal text search may miss documents that use different wording, while searching source code with this tool is outside its intended scope.

zvec — Cursor rule for Cursor by alexqem/zvec-tool

Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo

git clone --depth 1 https://github.com/alexqem/zvec-tool

agentmods

npx agentmods add rules/alexqem/zvec-tool/zvec

Made for: Cursor.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/rules/alexqem/zvec-tool/zvec/github.svg)](https://agentmods.dev/rules/alexqem/zvec-tool/zvec)

Your own site

<a href="https://agentmods.dev/rules/alexqem/zvec-tool/zvec"><img src="https://agentmods.dev/badge/rules/alexqem/zvec-tool/zvec/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/rules/alexqem/zvec-tool/zvec"><img src="https://agentmods.dev/badge/rules/alexqem/zvec-tool/zvec.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 0 Nothing until a file matches its globs; then the whole rule loads.

When invoked 765 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00000	$0.00765
Opus 5.5	$0.00000	$0.00306
Sonnet 5.5	$0.00000	$0.00153
Haiku 4.5	$0.00000	$0.00076

Measured 1mo ago against content hash ba6b422b137d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

zvec scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursor/rules/zvec.mdc · 82 lines

How it starts

The opening of the file, as written. The whole thing — 82 lines — stays where its author put it; the contents beside it link to each section on GitHub.

zvec — semantic search skill

zvec-tool is a CLI for semantic search over the project knowledge base. It turns documents into a vector index and retrieves relevant fragments by meaning. Use it to find docs, regulations, and business-process notes before doing broad greps.

Model: intfloat/multilingual-e5-small (384-dim, multilingual)
Indexed scope: the folder you pass to index (only *.md by default; configure via ZVEC_EXTENSIONS)
No global DB lock: withCollection opens/closes the DB per call, so search never blocks index

When to use

Call zvec search when you need to:

find how a business process is described/documented
locate documentation for a specific entity (справочник/документ/регистр)
find related regulations or concepts
get context before changing project configuration

Do not use zvec to search source code or config files — it only indexes the document folder you configured. For code, run a normal grep instead.

Search command

Run from the project root (the parent of zvec-tool/):

node zvec-tool/zvec.mjs search "<query in RU or EN>" --top 8

Flag	Description
`--top N`	Number of results (default: 8)
`--json`	Machine-readable JSON output

Examples

node zvec-tool/zvec.mjs search "учёт товаров на складе" --top 5
node zvec-tool/zvec.mjs search "регистр накопления остатки" --top 8
node zvec-tool/zvec.mjs search "порядок закрытия месяца" --top 6
node zvec-tool/zvec.mjs search "документ поступление" --json

Each result contains: the file path, a score (cosine similarity, > 0.7 is strong), and a 220-char preview. Results are sorted by descending score.

Rebuild the index

# Path is required — point it at your documents folder
node zvec-tool/zvec.mjs index ./docs
# or: node zvec-tool/zvec.mjs index --root ./docs
# or set ZVEC_INDEX_ROOT=./docs

Status & diagnostics

node zvec-tool/zvec.mjs status     # index status: docCount, active version
node zvec-tool/zvec.mjs doctor     # detailed diagnostics (probes DB, shows lock holder)

Read the full file on GitHub · 82 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

1mo ago First seen · 82 lines · 0 tokens per session scan A ba6b422b137d

Subscribe to this mod's changes

zvec is a cursor rule published in the GitHub repository alexqem/zvec-tool (2 stars, last pushed 3mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 765 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Data and AI RAG and vectors Research

cardano-mcp

These rules complement our main development collaboration rules, focusing specifically on the Model Context Protocol (MCP) server project with TypeScript. This project serves as a specialized RAG (Retrieval-Augmented Generation) gateway to existing Cardano resources, documentation, and tools to assist with dApp…

Jimmyh-world/Cardano_MCP · 3,030 tokens

zvec

Getting it into your agent

Wrote this? Show the measurements

What it costs to keep this loaded

Grade A, and why

Nothing flagged

How it starts

zvec — semantic search skill

When to use

Search command

Examples

Rebuild the index

Status & diagnostics

What this file has done since we first saw it

Other cursor rules, from other repositories

cardano-mcp

005_Dynamo_KV_Cache_Management_KVBM

ponytail

angular-20

dev-standard

prefer-assertions-over-defensive-checks