Vector Setup
Bootstraps ruvector@0.3.13 and its optional add-ons so every /vector subcommand actually works on first run.
Why this exists
Out of the box, several /vector subcommands fail with a confusing dep error:
| Error | Missing package |
|---|---|
ONNX WASM files not bundled. The onnx/ directory is missing. |
none — upgrade to ruvector 0.3.3 or later, which bundles it (0.2.x lacks it) |
requires @ruvector/rabitq-wasm (or diskann, router, graph, rvlite, rvf, tiny-dancer) |
npx -y ruvector@0.3.13 add <extra> installs it into this project (0.3.8); add --list shows what is installed |
Brain commands require @ruvector/pi-brain |
@ruvector/pi-brain |
SONA not available. Native error: Cannot find module '/.../@ruvector/sona/index.js' |
@ruvector/ruvllm (JS fallback) |
LLM commands require @ruvector/ruvllm |
@ruvector/ruvllm |
This skill installs them in one pass.
Steps
Pin ruvector:
npm install ruvector@0.3.13Install the add-ons (idempotent — only what's missing):
npm install @ruvector/pi-brain \ @ruvector/ruvllmFor a leaner install, pass
--fullto also pull@ruvector/graph-nodeand@ruvector/router:npm install @ruvector/pi-brain \ @ruvector/ruvllm \ @ruvector/graph-node \ @ruvector/routerVerify the binary:
npx -y ruvector@0.3.13 doctor npx -y ruvector@0.3.13 infoRegister the MCP server:
claude mcp add ruvector -- npx -y ruvector@0.3.13 mcp start claude mcp list | grep ruvectorSince 0.3.4 the MCP server is locked down by default. Two env vars widen it, and only on purpose:
RUVECTOR_MCP_ALLOW_INIT=1letshooks_initandhooks_doctor --fixwrite project config. Without it they refuse.RUVECTOR_MCP_ROOTS=/path/a:/path/badds directories the hooks file tools may read. Without it they stay inside the working directory (0.3.7).
Pass them with
claude mcp add ruvector -e RUVECTOR_MCP_ALLOW_INIT=1 -- npx -y ruvector@0.3.13 mcp startonly for a setup session, then re-register without the flag.Upgrading from an older pin: remove and re-add the server at 0.3.13 (
claude mcp remove ruvector, then theaddline above). The ruflo-console vector page runsnpx --offline -y ruvector@0.3.13, which works only once 0.3.13 is in the npx cache.Since 0.3.5 a project with no
.ruvector/directory uses its own store, not~/.ruvector. Memories recorded before that sit in the home store and do not show up in a new project.Sanity check the most common subcommands:
npx -y ruvector@0.3.13 hooks route "test" npx -y ruvector@0.3.13 attention list npx -y ruvector@0.3.13 rvf examples(Optional) Generate a pi identity for brain + edge:
npx -y ruvector@0.3.13 identity generate npx -y ruvector@0.3.13 identity show
Smoke test
For a deterministic verification of the install, run the plugin's bundled smoke script:
bash plugins/ruflo-ruvector/scripts/smoke.sh
It checks: version pin, top-level subcommand visibility, hooks ast-analyze, hooks route, attention list, rvf examples, and info. Exits non-zero if any drift from the contracted surface is detected.
What this does not install
- Native Rust toolchain (optional; only needed for source builds)
- Platform-specific native bindings (auto-detected by
@ruvector/core) @ruvector/sonanative binding (the JS fallback via@ruvector/ruvllmis sufficient on macOS arm64; Linux x64 has its own native binding)
If doctor still reports a problem after this skill runs, paste its output verbatim and ask.
