ruvnet--ruflo/plugins/ruflo-ruvector/commands/vector.md

name, description

name	description
vector	RuVector operations via npx ruvector@0.2.25 — embedding, search, RVF cognitive containers, GNN, attention, hooks, brain, sona, edge, identity

$ARGUMENTS Vector operations via the ruvector npm package (pinned to 0.2.25). Parse subcommand from $ARGUMENTS.

Pinned version: ruvector@0.2.25 — every command below uses npx -y ruvector@0.2.25 ....

Usage: /vector [options]

Embedding

1. embed <text> — npx -y ruvector@0.2.25 embed text "TEXT" 384-dim ONNX vector. If ONNX WASM files not bundled, run /vector setup.
2. embed-adaptive <text> — npx -y ruvector@0.2.25 embed text "TEXT" --adaptive --domain code LoRA-adapted embedding tuned to a domain.
3. embed-file <path> — Read file, then npx -y ruvector@0.2.25 embed text "$(cat <path>)" -o <path>.vec.json
4. embed-benchmark — npx -y ruvector@0.2.25 embed benchmark (compares base vs adaptive).

Database lifecycle

5. db create <path> — npx -y ruvector@0.2.25 create <path> -d 384 -m cosine
6. db stats <path> — npx -y ruvector@0.2.25 stats <path>
7. insert <database> <json-file> — npx -y ruvector@0.2.25 insert <database> <json-file>
8. search <database> <vector-json> [-k N] — npx -y ruvector@0.2.25 search <database> -v '[0.1,...]' -k N
9. export <database> [-o file] [-f json|binary|parquet] [--compress] — npx -y ruvector@0.2.25 export <database> -o backup.json
10. import <file> [-d database] — npx -y ruvector@0.2.25 import <file> -d <database> [--merge|--replace]

RVF (cognitive containers)

11. rvf create <path> — npx -y ruvector@0.2.25 rvf create <path>
12. rvf ingest <path> — npx -y ruvector@0.2.25 rvf ingest <path>
13. rvf query <path> — npx -y ruvector@0.2.25 rvf query <path> (nearest neighbors)
14. rvf status <path> — npx -y ruvector@0.2.25 rvf status <path>
15. rvf segments <path> — npx -y ruvector@0.2.25 rvf segments <path>
16. rvf derive <parent> <child> — npx -y ruvector@0.2.25 rvf derive <parent> <child> (lineage tracking)
17. rvf compact <path> — npx -y ruvector@0.2.25 rvf compact <path> (reclaim deleted space)
18. rvf examples — npx -y ruvector@0.2.25 rvf examples (45 reference stores)
19. rvf download <name> — npx -y ruvector@0.2.25 rvf download <name> (e.g. agent_memory, swarm_knowledge)

GNN (Graph Neural Networks)

20. gnn info — npx -y ruvector@0.2.25 gnn info
21. gnn layer — npx -y ruvector@0.2.25 gnn layer (build/test a multi-head attention GNN layer)
22. gnn search — npx -y ruvector@0.2.25 gnn search (differentiable soft-attention search)
23. gnn compress — npx -y ruvector@0.2.25 gnn compress (5-level adaptive tensor compression)

Attention mechanisms

24. attention list — npx -y ruvector@0.2.25 attention list Lists ALL available mechanisms: DotProduct, MultiHead, Flash, Hyperbolic, Linear, MoE, GraphRoPe, EdgeFeatured, DualSpace, LocalGlobal.
25. attention compute — npx -y ruvector@0.2.25 attention compute
26. attention benchmark — npx -y ruvector@0.2.25 attention benchmark
27. attention hyperbolic — npx -y ruvector@0.2.25 attention hyperbolic (Poincare-ball geometry ops; the real hyperbolic surface in 0.2.25)
28. attention info — npx -y ruvector@0.2.25 attention info

Code intelligence (hooks)

29. hooks init — npx -y ruvector@0.2.25 hooks init --pretrain --build-agents quality
30. hooks stats — npx -y ruvector@0.2.25 hooks stats (Q-learning patterns, vector memories, trajectories)
31. hooks route <task> — npx -y ruvector@0.2.25 hooks route "DESCRIPTION" (positional)
32. hooks route-enhanced <task> — npx -y ruvector@0.2.25 hooks route-enhanced "DESCRIPTION"
33. hooks suggest-context — npx -y ruvector@0.2.25 hooks suggest-context
34. hooks ast-analyze <file> — npx -y ruvector@0.2.25 hooks ast-analyze <file> (positional)
35. hooks ast-complexity <files...> — npx -y ruvector@0.2.25 hooks ast-complexity <files...>
36. hooks diff-analyze [commit] — npx -y ruvector@0.2.25 hooks diff-analyze HEAD
37. hooks diff-classify [commit] — npx -y ruvector@0.2.25 hooks diff-classify HEAD
38. hooks diff-similar — npx -y ruvector@0.2.25 hooks diff-similar
39. hooks coverage-route <file> — npx -y ruvector@0.2.25 hooks coverage-route <file>
40. hooks coverage-suggest <files...> — npx -y ruvector@0.2.25 hooks coverage-suggest <files...>
41. hooks graph-cluster <files...> — npx -y ruvector@0.2.25 hooks graph-cluster <files...> (spectral/Louvain)
42. hooks rag-context <query> — npx -y ruvector@0.2.25 hooks rag-context "QUERY"
43. hooks security-scan <files...> — npx -y ruvector@0.2.25 hooks security-scan <files...> (run hooks init first)
44. hooks remember <content> — npx -y ruvector@0.2.25 hooks remember "CONTENT"
45. hooks recall <query> — npx -y ruvector@0.2.25 hooks recall "QUERY"
46. hooks coedit-record / coedit-suggest — record + retrieve files edited together.
47. hooks error-record / error-suggest — learn error→fix pairs and retrieve.
48. hooks trajectory-begin / trajectory-step / trajectory-end — record an execution trajectory.
49. hooks pre-edit / post-edit / pre-command / post-command / session-start / session-end — Claude Code hook lifecycle.

Known bugs in 0.2.25 hooks: force-learn raises intel.tick is not a function; graph-mincut raises Cannot read properties of undefined; git-churn fails outside a git repo. Avoid these or run inside a git repo with seeded intelligence state.

Native + workers (background analysis)

50. native list — npx -y ruvector@0.2.25 native list (worker types: security, analysis, learning)
51. native run <type> — npx -y ruvector@0.2.25 native run security (or analysis|learning)
52. native benchmark — npx -y ruvector@0.2.25 native benchmark
53. native compare — npx -y ruvector@0.2.25 native compare
54. workers triggers / presets / phases / dispatch / status / stats / cleanup / cancel / run / create / init-config — all available via npx -y ruvector@0.2.25 workers <subcmd>. First invocation auto-installs agentic-flow (slow).

Collective knowledge (brain) — needs @ruvector/pi-brain

55. brain status — npx -y ruvector@0.2.25 brain status
56. brain search <query> — npx -y ruvector@0.2.25 brain search "QUERY"
57. brain share <title> — npx -y ruvector@0.2.25 brain share "TITLE"
58. brain list / get / vote / delete / drift / partition / transfer / sync / page — full Brainpedia + LoRA-weight management.

SONA (Self-Optimizing Neural Architecture) — needs @ruvector/ruvllm

59. sona status / info / stats — npx -y ruvector@0.2.25 sona status
60. sona patterns <query> — npx -y ruvector@0.2.25 sona patterns "QUERY"
61. sona train <data> — npx -y ruvector@0.2.25 sona train <data> (record a training trajectory)
62. sona export — npx -y ruvector@0.2.25 sona export (export learned weights)

LLM orchestration — needs @ruvector/ruvllm

63. llm models — npx -y ruvector@0.2.25 llm models
64. llm embed <text> — npx -y ruvector@0.2.25 llm embed "TEXT" (RuvLLM-backed embeddings)
65. llm benchmark — npx -y ruvector@0.2.25 llm benchmark
66. llm info — npx -y ruvector@0.2.25 llm info

Identity (pi key for brain/edge/MCP)

67. identity generate — npx -y ruvector@0.2.25 identity generate (creates a 64-hex-char pi key)
68. identity show — npx -y ruvector@0.2.25 identity show
69. identity export -o file — npx -y ruvector@0.2.25 identity export -o key.enc (encrypted backup)
70. identity import <file> — npx -y ruvector@0.2.25 identity import <file>

Edge compute network

71. edge status — npx -y ruvector@0.2.25 edge status
72. edge balance [nodeId] — npx -y ruvector@0.2.25 edge balance (rUv balance)
73. edge tasks — npx -y ruvector@0.2.25 edge tasks
74. edge join — npx -y ruvector@0.2.25 edge join (join the network as a node)
75. edge dashboard — npx -y ruvector@0.2.25 edge dashboard (opens in browser)

Server / Decompile / Demo

76. server [-p 8080] [-g 50051] [-d data-dir] — npx -y ruvector@0.2.25 server -p 8080
77. decompile <target> [-o dir] [-f modules|single|json] — npx -y ruvector@0.2.25 decompile <npm-pkg-or-file-or-url>
78. demo --basic | --gnn | --graph — npx -y ruvector@0.2.25 demo --basic (interactive tutorial)

System

79. doctor — npx -y ruvector@0.2.25 doctor (Node, npm, bindings, Rust)
80. info — npx -y ruvector@0.2.25 info
81. benchmark — npx -y ruvector@0.2.25 benchmark (known issue: fails with Missing field 'dimensions' on some installs; use gnn search or attention benchmark as alternatives)
82. install [pkg|--all] — npx -y ruvector@0.2.25 install --all (lists/installs optional add-ons)
83. setup — npx -y ruvector@0.2.25 setup (Setup Guide)

Setup helper

For first-run users hitting ONNX WASM files not bundled, Brain commands require @ruvector/pi-brain, or SONA not available, invoke the vector-setup skill: /vector-setup.

MCP server (91 tools)

• Register once: claude mcp add ruvector -- npx -y ruvector@0.2.25 mcp start
• Verify: claude mcp list | grep ruvector
• Then call MCP tools directly (e.g. hooks_route, hooks_ast_analyze, hooks_rag_context, brain_search, attention_list).

Not in 0.2.25 (do not invoke)

compare, top-level index, midstream, embed --file, embed --batch --glob, cluster --namespace --k (top-level cluster is "Coming Soon"), embed --model poincare, optimize (per its own message: "not yet shipped in this release"), brain agi * (use brain status directly).