OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Agent Memory & RAG

Agent Brain

Agent Brain is a local-first Python RAG system that indexes documentation and source code for natural-language search by AI agents and applications. It combines a FastAPI indexing and retrieval server with a CLI, an MCP server, and plugins for coding-assistant environments.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Agent Brain — OpenViST project profile in Agent Memory & RAG.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use Agent Brain when an agent needs searchable project context—for example, to investigate an authentication implementation across documentation and source code, find exact function names, or trace dependencies.

Who it is for

  • Developers who want agents to retrieve answers from project documentation and source code.
  • Teams using Claude Code, Codex, OpenCode or other documented plugin hosts.
  • Builders connecting an MCP-compatible agent client to an indexed knowledge base.

Documented uses

  • Index project documentation and code for later retrieval.
  • Search conceptual topics, exact terms, or code relationships using different retrieval modes.
  • Give an agent a project-specific retrieval layer through a plugin or MCP connection.
  • Explore a codebase with multi-step searches and synthesized research answers.
Before you choose

Requirements & limits

The project is an open-source repository under the MIT license. The documented setup runs the server as part of a project rather than using a hosted search service.

  • The documented development prerequisites are Python 3.10 or later, Poetry and Task; the CLI packages are installed with pip.
  • The Claude Code setup wizard can install packages, configure API keys, initialize the project, start the server and index documentation.
  • Embedding providers listed include OpenAI, Ollama and Cohere; the documentation identifies Ollama models as local options.
  • The CLI documentation describes API-key configuration during initialization and an API-key requirement for data endpoints.
  • Other plugin hosts use the CLI-based installation path, with --with-mcp registering the MCP server in the host configuration.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Set up Agent Brain through the Claude Code plugin

Install the plugin, initialize a project, start the server and index its documentation using the documented setup wizard.

Before you start

  • Claude Code
  • An API key configured through the setup wizard

Steps

  1. Add the Agent Brain marketplace with claude plugins marketplace add SpillwaveSolutions/agent-brain.

  2. Install it with claude plugins install agent-brain@agent-brain-marketplace.

  3. In Claude Code, run /agent-brain-setup to install the Python packages, configure API keys, initialize the project, start the server and index documentation.

  4. Search the indexed material with a command such as /agent-brain-search "how does authentication work".

Expected outcome

A project with indexed documentation that can be searched through the Claude Code plugin.

Guide limitations

  • The wizard's documented setup covers indexing documentation; code indexing is described separately in the CLI usage.
  • The repository names Codex, Cursor, Grok Build and OpenCode as other plugin hosts, but this recipe covers Claude Code.
Documentation 1 ↗
Source-based practical guide

Index and query project material with the CLI

Initialize Agent Brain, start its server, index a documentation directory and query the indexed content.

Before you start

  • Python 3.10 or later
  • The agent-brain-rag and agent-brain-cli Python packages

Steps

  1. Install the packages with the command below.

    Documented command
    pip install agent-brain-rag agent-brain-cli

  2. Initialize the project with agent-brain init.

  3. Start the server with agent-brain start --daemon.

  4. Index a directory with agent-brain index /path/to/docs --include-code.

  5. Query it with agent-brain query "authentication" --mode hybrid.

Expected outcome

A running local service with indexed material available for hybrid CLI queries.

Guide limitations

  • The README says API keys are configured during initialization and describes an API-key requirement for data endpoints; review the current authentication guidance before changing the default configuration.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
13 October 2026
Original website title
SpillwaveSolutions/agent-brain · Official homepage title · retained in its source language
How we review sourcesSuggest a correction

Related options

Claude Code plugin — An included interface to Agent Brain's indexing and search features, with slash commands, skills and agents.

Agent Brain CLI — A direct command-line interface for initializing the project, starting the server, indexing material and querying it.

Agent Brain MCP server — An integration component that exposes retrieval to MCP-compatible agent clients.