RuvNet Brain
Source-grounded companion that helps Claude Code and Codex discover and use RuvNet ecosystem source.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Node.js 18 or newer
global npm install of ruvnet-brain package
npm install -g ruvnet-brain@latestrun installer to fetch signed knowledge bundle and models
ruvnet-brain --yes --no-nightly-prompt --no-telemetry --no-stack --no-enhance --no-statusline --no-selfcheck
Where the README and reality differ
- README: npx ruvnet-brain@latest installs in one step
What worked: run installer after npm install: ruvnet-brain --yes --no-nightly-prompt --no-telemetry --no-stack --no-enhance --no-statusline (fetches 1.5GB KB + 257MB models); until then --doctor reports brain not found
Check that it works
ruvnet-brain --helpThe output should contain “It is safe to re-run at any time”.
First thing to try
ruvnet-brain --doctorAdd it to your agent
claude mcp add ruvnet-brain -- node $HOME/.local/lib/node_modules/ruvnet-brain/plugin/mcp/server.mjsJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"ruvnet-brain": {
"command": "sh",
"args": [
"-c",
"exec node \"$HOME/.local/lib/node_modules/ruvnet-brain/plugin/mcp/server.mjs\""
]
}
}
}Run ruvnet-brain --doctor to check the setup, then use the search_ruvnet tool from Claude Code or Codex.
What it does
- Ask in plain language which RuvNet tools fit a needTested
How to use it
- In Claude Code or Codex, call the search_ruvnet tool.
- Pass your question as the query, such as "<your question>".
- Read the text answer listing matching RuvNet options.
- Search source code with repository citationsNot shown working
- Keep useful project context to recall laterNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- 1 of 3 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- Show how Ruflo coordinates agents with implementing source
- Show how RVF stores and queries vectors with source citations
- Compare RuvNet approaches for routing model calls
- Review a project agent workflow and propose smallest verifiable change
- Find RuvNet options for persistent agent memory
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 4.7.23
An MCP client handshake over stdio listed 4 tools, and a call to search_ruvnet returned a result.
Differences the test machine hit
- README: installer exits 0 after successful install
In the test: add --no-selfcheck for exit 0 on a machine with no Claude Code/Codex plugin; without it installer exits 1 with no-plugin hooks violation even though Knowledge checks are green - README: standard --version prints tool version
In the test: ruvnet-brain --version requires a release tag (e.g. --version vX.Y.Z) and exits 1; use ruvnet-brain --help / --doctor and read version 4.7.23 from package.json