By Goldziher
Query your codebase using natural language and structured commands — search symbols, blame lines, diff commits, and retrieve documentation from PDFs, Office files, and web pages without opening files. Coordinate multiple AI agents working on the same repository with shared memory and scoped rooms.
Diagnose and recover basemind when it isn't working (MCP tools missing/erroring, "no index", dead server) — runs CLI checks and gives the client-specific way to reconnect the server.
Onboard (or refresh) basemind in this repo — write basemind.toml, gitignore the cache, and inject a "prefer basemind over grep/read/git" rules block into CLAUDE.md / AGENTS.md / ai-rulez.
Build or refresh the basemind index by running `basemind scan` via the CLI — works without the MCP server (use it when basemind reports "no index" / "no indexed files").
Show the basemind dashboard — resource footprint (disk + RAM) and activity (tool calls, per-tool histogram, estimated tokens saved). Works with or without the MCP server.
Enable the basemind status line in your Claude Code user settings (one-time setup).
Navigate codebases and manage caches via the basemind CLI — outlines, symbol search, reference/caller lookups, git history, blame, and diffs. For headless scripting, CI, or when driving the CLI more efficiently than interactive MCP calls. Shares the same index as the MCP server.
Find where code is defined and used without reading files — symbol search, file outlines, references, callers, call graphs, implementations, dependents, and indexed regex over content. Reach for it whenever the user asks "where is X defined", "what calls Y", "what implements Z", "what's the shape of this file", or whenever you're about to grep or open files to learn structure.
Coordinate with other agents working the same repo via basemind's broker — scoped threads, a per-agent inbox, and two-tier messages. Reach for it whenever you start, finish, or hit a decision while collaborating, or to check whether another agent is already touching the code you're about to change.
Diagnose and recover basemind when it isn't working — MCP tools missing or erroring, "no index" / "no indexed files", empty results that shouldn't be empty, or the MCP server seems dead. Runs CLI checks (no MCP server required) and gives the client-specific way to reconnect the server.
Semantic + full-text search over documents and the web via basemind's RAG store — PDFs, Office, HTML, email, images (OCR), plus scraped/crawled web pages, with cross-encoder reranking, keyword and named-entity (NER) filters, and per-document summaries. Reach for it whenever the user asks to "search the docs / PDFs", "find where a topic is discussed", "pull this URL into context", or "what does the documentation say about X".
Admin access level
Server config contains admin-level keywords
Executes bash commands
Hook triggers when Bash tool is used
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
The context and communication layer for coding agents.
basemind turns any repo into an always-current map of its code, documents, history, and memory —
so agents answer from structure and search instead of burning their context window on grep and
file reads — and gives a team of agents a shared channel to coordinate while they work. One
server does both.
Code map across 300+ languages · documents in 90+ formats · semantic + full-text search · git history & blame · shared memory · web crawl · agent-to-agent comms
Docs · Install · Features · How it works · Performance · CLI

An agent reasoning from structure — outline + find_references in a live session, statusline tracking tokens saved.
basemind answers with file paths, line numbers, and signatures — not whole files — so a question about your code costs a small fraction of the tokens it takes to read the source.
| Capability | What it does | Key tools |
|---|---|---|
| Code intelligence | Find where things are defined, what calls what, who implements what, how calls chain, and the overall architecture (hub modules + dependency cycles) — with precise, scope- and import-aware resolution (JS/TS via oxc, Python & Java via in-tree stack-graphs) layered over 300+ languages. | outline · search_symbols · find_references · find_callers · goto_definition · call_graph · architecture_map · find_implementations · find_files · workspace_grep |
| Git intelligence | Ask what changed recently, who last touched a function, where the churn is, how a file's structure differs across commits, and full-text search commit authors + messages. | blame_symbol · symbol_history · recent_changes · hot_files · diff_outline · commits_touching · search_git_history |
| Document search | Search PDFs, Office files, HTML, email, and images by meaning — with built-in text extraction and OCR, no extra setup. | search_documents |
| Code search | Find source code by meaning, term, or symbol — mode picks the strategy: hybrid (default, RRF fusion of vector + BM25 + exact-symbol lanes), semantic (vector KNN), or keyword (native BM25); optional rerank cross-encoder pass. Returns pointers, fetch bodies with get_chunk. Needs --features code-search. | search_code · get_chunk |
| Shared memory | A per-repo memory agents can write to and search; clones of the same repo share it, unrelated repos stay separate. | memory_put · memory_search · memory_audit |
| Suggestions | Spots files that change together and suggests notes worth saving — you approve before anything is kept. | proposals_mine · proposal_accept |
| Web crawl | Fetch a page or follow links from a starting URL; results join the document search above. | web_scrape · web_crawl · web_map |
| Agent comms | Threads for agents working the same repo: each addressed by at least two of subject / path-glob / members, discovered by scope (member, cwd path-match, or subject filter — never global), with a recency-filtered inbox. The creator manages membership and archives; idle threads auto-archive. One orchestrator can drive many named subagents (as_agent). | thread_start · thread_post · thread_list · inbox_read · inbox_wait · agent_list |
| Agent shells | Let agents open, type into, and watch terminal sessions in the background. | shell_spawn · shell_send · shell_capture · shell_list |
npx claudepluginhub goldziher/basemind --plugin basemindRepository knowledge engine plugin. Bundles CLI-backed slash commands (rb-setup / rb-init / rb-refresh / rb-ask) plus the agent-repo-init skill. Works in both Claude Code and Codex CLI.
Optimized file search, semantic indexing, and persistent memory for Claude Code — with optional sync to a self-hosted web dashboard
Local-first memory server — hybrid BM25+vector search, vault management, lint, and launchd lifecycle for project knowledge.
Fast and token-friendly code reading for AI coding agents. Symbol-aware MCP tools that replace cat/grep with ~85% fewer tokens, sub-millisecond search, and a raw fallback that preserves cat/grep parity byte-for-byte.
Persistent project memory for AI coding agents — semantic search, AST-aware chunking, dependency graphs, and conversation history
Local repo-intelligence index + MCP server: semantic search, symbol/graph navigation, impact-surface preflight, git + GitHub papertrail, and a source-anchored memory graph.