---

last_validated: 2026-03-16

Agent Brain

A RAG-based (Retrieval-Augmented Generation) document indexing and semantic search system for AI agents and applications. Agent Brain enables intelligent querying of documentation and source code using natural language.

Overview

Agent Brain provides AI-first document and code search through a Claude Code plugin with skills, commands, and agents. Use slash commands to search, agents for complex research tasks, and skills for intelligent query optimization.

Component	Description
Plugin	30 slash commands, 3 agents, 2 skills for Claude Code
Skills	Intelligent search mode selection and query optimization
Agents	Research assistant, search assistant, setup assistant
Server	FastAPI backend for indexing and retrieval
CLI	Command-line tool (also used by plugin internally)

Quick Start (Claude Code Plugin)

1. Install the Plugin

# 1. Add the Agent Brain marketplace (the repo is a plugin marketplace)
claude plugins marketplace add SpillwaveSolutions/agent-brain

# 2. Install the plugin from that marketplace
claude plugins install agent-brain@agent-brain-marketplace

Installing a Claude Code plugin does not use pip. The plugin is installed through the marketplace above; the underlying Python packages (agent-brain-rag, agent-brain-cli) are installed for you by the /agent-brain-setup wizard (or manually via pip — see CLI Usage).

Other hosts

The same plugin installs into Codex, Cursor, Grok Build, and OpenCode through the CLI. Each command converts the shared payload into the host's native layout and, with --with-mcp, registers the MCP server in that host's config file.

pip install agent-brain-rag agent-brain-cli agent-brain-ag-mcp
agent-brain install-agent --agent codex --with-mcp     # .codex/skills/agent-brain + AGENTS.md; MCP in ~/.codex/config.toml
agent-brain install-agent --agent cursor --with-mcp    # .cursor/plugins/agent-brain + .cursor/rules; MCP in .cursor/mcp.json
agent-brain install-agent --agent grok --with-mcp      # .grok/plugins/agent-brain; zero-config Claude load, MCP in .mcp.json
agent-brain install-agent --agent opencode --with-mcp  # .opencode/plugins/agent-brain; MCP in opencode.json

A conforming Agent Plugins 1.0 client reads agent-brain-plugin/plugin.json, skills/, and mcp.json directly. See docs/HOSTS.md for the manifest each host reads.

2. Set Up Your Project

In Claude Code, run:

/agent-brain-setup

This interactive wizard will:

• Install the Python packages (agent-brain-rag, agent-brain-cli)
• Configure your API keys
• Initialize the project
• Start the server
• Index your documentation

3. Search with Commands

/agent-brain-search "how does authentication work"

That's it! The plugin handles everything automatically.

Plugin Commands

Search Commands

Command	Description	Use When
/agent-brain-search	Smart hybrid search (recommended)	General questions
/agent-brain-semantic	Pure semantic/vector search	Conceptual queries
/agent-brain-keyword	BM25 keyword search	Error messages, function names
/agent-brain-hybrid	Hybrid with alpha tuning	Fine-tuned searches
/agent-brain-graph	Knowledge graph search	"What calls X?", dependencies
/agent-brain-multi	All modes combined (RRF)	Maximum recall

Server Commands

Command	Description
/agent-brain-start	Start the server (auto-port)
/agent-brain-stop	Stop the server
/agent-brain-status	Check health and document count
/agent-brain-index	Index documents or code

Setup Commands

Command	Description
/agent-brain-setup	Complete guided setup w

... View full README on GitHub