Help us improve
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
Index project documentation, codebases, and knowledge graphs for hybrid retrieval: BM25 keywords, semantic similarity, GraphRAG relationships, or fused multi-mode search. Retrieve cited chunks with scores to research dependencies, errors, and concepts in seconds using Ollama, OpenAI, or Anthropic.
npx claudepluginhub spillwavesolutions/agent-brain --plugin agent-brainSearch using BM25 keyword matching for exact terms
View embedding cache metrics or clear the cache
12-step wizard to configure all Agent Brain settings — providers, storage, GraphRAG, reranking, caching, file watcher, chunking, and server deployment
Configure the embedding provider for vector search
Manage indexed folders — list, add, or remove
Intelligent research agent that uses Agent Brain for knowledge retrieval with adaptive search modes
Proactively assists with document and code search using Agent Brain
Proactively assists with Agent Brain installation and configuration
Installation and configuration skill for Agent Brain document search system. Use when asked to "install agent brain", "setup agent brain", "configure agent brain", "setting up document search", "installing agent-brain packages", "configuring API keys", "initializing project for search", "troubleshooting agent brain", "pip install agent-brain", "agent brain not working", "agent brain setup error", "configure embeddings provider", "setup ollama for agent brain", or "agent brain environment variables". Covers package installation, provider configuration, project initialization, and server management.
Expert Agent Brain skill for document search with BM25 keyword, semantic vector, hybrid, graph, and multi retrieval modes. Use when asked to "search documentation", "query domain", "find in docs", "bm25 search", "hybrid search", "semantic search", "graph search", "multi search", "find dependencies", "code relationships", "searching knowledge base", "querying indexed documents", "finding code references", "exploring codebase", "what calls this function", "find imports", "trace dependencies", "brain search", "brain query", "knowledge base search", "cache management", "clear embedding cache", "cache hit rate", or "cache status". Supports multi-instance architecture with automatic server discovery. GraphRAG mode enables relationship-aware queries for code dependencies and entity connections. Pluggable providers for embeddings (OpenAI, Cohere, Ollama) and summarization (Anthropic, OpenAI, Gemini, Grok, Ollama). Supports multiple runtimes (Claude Code, OpenCode, Gemini CLI) with shared .agent-brain/ data directory.
Uses power tools
Uses Bash, Write, or Edit tools
Share bugs, ideas, or general feedback.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Local-first memory server — hybrid BM25+vector search, vault management, lint, and launchd lifecycle for project knowledge.
Optimized file search, semantic indexing, and persistent memory for Claude Code — with optional sync to a self-hosted web dashboard
Use probe to search indexed project knowledge from docs and code through MCP.
Local RAG system with embedded Multi-Agent Framework for Claude Code plugin
Repository knowledge engine plugin. Bundles CLI-backed slash commands (ag-setup / ag-init / ag-refresh / ag-ask) plus the agent-repo-init skill. Works in both Claude Code and Codex CLI.
CodeAlive context engine for semantic code search and AI-powered codebase Q&A. Enables AI coding agents to understand entire codebases beyond just open files — search across all indexed repositories, trace cross-service dependencies, discover usage patterns, and get synthesized answers to architectural questions. Includes a lightweight code exploration subagent, authentication hooks, and multiple search modes (fast lexical, semantic, and deep cross-cutting). Works standalone or alongside the CodeAlive MCP server for direct tool access via the Model Context Protocol.
Automates macOS apps via Apple Events using AppleScript (discovery) and JXA (production logic). Use when asked about AppleScript, JXA, osascript, or macOS app automation.
Build, test, and debug AWS-native systems locally with LocalStack (Community/Pro) using awslocal, IaC toolchains, event-driven pipelines, and observability; includes setup, deployment, management, monitoring, and sharp-edge guidance.
Debugging-first guidance for professional Docker development across CLI, Compose, Docker Desktop, and Rancher Desktop
Wizard-style codebase explainer and documentation generator. Accepts any codebase, spec, or markdown artifact and explains it through conversational Q&A — with code-block anchors, plain-English explanations, and follow-up predictions. Two modes: Describe (repo owner documents their codebase) and Explore (new developer gets a learning-order tour). Sessions auto-captured and synthesizable as CODEBASE.md or TOUR.md.
Generate validated design documentation for any codebase. Walks a repo bottom-up and emits a docs/design/ tree: per-class docs, package rollups, mermaid diagrams (syntax + semantic validated), tech-debt ledger, system design, and unresolved HIL disputes YAML.
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.
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 | 24 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) |
claude plugins install github:SpillwaveSolutions/agent-brain
In Claude Code, run:
/agent-brain-setup
This interactive wizard will:
agent-brain-rag, agent-brain-cli)/agent-brain-search "how does authentication work"
That's it! The plugin handles everything automatically.
| 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 |
| 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 |
| Command | Description |
|---|---|
/agent-brain-setup | Complete guided setup wizard |
/agent-brain-install | Install pip packages |
/agent-brain-init | Initialize project directory |
/agent-brain-verify | Verify configuration |
/agent-brain-providers | Configure embedding/summarization providers |
Agent Brain includes three intelligent agents for complex tasks:
| Agent | Description | Triggered By |
|---|---|---|
| Search Assistant | Multi-step search across modes, synthesizes answers | "Find all references to...", "Research how..." |
| Research Assistant | Deep exploration with follow-up queries | "Investigate...", "Analyze the architecture of..." |
| Setup Assistant | Guided installation and troubleshooting | "Help me set up Agent Brain", configuration issues |
You: "Research how authentication is implemented across the codebase"
Research Assistant:
Skills provide intelligent context to Claude for optimal searching:
| Skill | Purpose |
|---|---|
| using-agent-brain | Search mode selection, query optimization, API knowledge |
| configuring-agent-brain | Installation, provider configuration, troubleshooting |
When you ask about documentation or code, Claude automatically uses the skill to:
| Mode | Best For | Example Query |
|---|---|---|
HYBRID | General questions (default) | "How does caching work?" |
VECTOR | Conceptual understanding | "Explain the architecture" |
BM25 | Exact terms, error codes | "NullPointerException", "getUserById" |
GRAPH | Relationships, dependencies | "What classes use AuthService?" |
MULTI | Comprehensive search | "Everything about data validation" |
Agent Brain supports multiple providers for embeddings and summarization:
| Provider | Models | Local |
|---|---|---|
| OpenAI | text-embedding-3-large, text-embedding-3-small | No |
| Ollama | nomic-embed-text, mxbai-embed-large | Yes |
| Cohere | embed-english-v3.0, embed-multilingual-v3.0 | No |