By Goldziher
Equip AI coding agents with deep codebase understanding via symbol navigation, call graphs, git history, and document RAG, enabling multi-agent collaboration and context-aware assistance across 300+ languages.
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.
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 basemind activity dashboard — tool calls, per-tool histogram, estimated tokens saved.
Enable the basemind status line in your Claude Code user settings (one-time setup).
Ask basemind anything about the current codebase — outlines, refs, callers, git history, blame, diffs, docs, memory.
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.
Coordinate with other agents working the same repo via basemind's broker — scoped rooms, 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.
Build or refresh the basemind index by running `basemind scan` via the CLI. Use this when basemind reports "no index" / "no indexed files", when the MCP server isn't available, or after large changes when the index is stale. Works without the MCP server — it shells the basemind binary directly.
Show a quick dashboard of basemind activity in this session: how many code-map tool calls have run, the per-tool histogram, and the estimated tokens saved vs a hypothetical grep+Read baseline. Use when the user asks "what has basemind done?", "how much is basemind helping?", "show me basemind stats", or invokes `/basemind-stats` directly.
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 claimnpx claudepluginhub goldziher/basemind --plugin basemindBased 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
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, and how calls chain — across 300+ languages. | outline · search_symbols · find_references · find_callers · call_graph · find_implementations · workspace_grep |
| Git intelligence | Ask what changed recently, who last touched a function, where the churn is, and how a file's structure differs across commits. | blame_symbol · symbol_history · recent_changes · hot_files · diff_outline · commits_touching |
| Document search | Search PDFs, Office files, HTML, email, and images by meaning — with built-in text extraction and OCR, no extra setup. | search_documents |
| 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 | A shared chat for agents on the same repo: per-repo rooms they auto-join, direct messages, and a recency-filtered inbox. One orchestrator can drive many named subagents (as_agent). | room_post · dm_send · inbox_read · agent_list |
| Agent shells | Let agents open, type into, and watch terminal sessions in the background. | shell_spawn · shell_send · shell_capture · shell_list |
| Token saving | Hand an agent a file's outline instead of its full text, then pull back only the one function it needs. | compress · expand |
| Admin | Refresh the index, see what's been queried, and check or clean up the on-disk cache. | rescan · telemetry_summary · cache_stats |
Three ways to run basemind, easiest first. All three share the same local index and are safe to run side by side.
The plugin downloads the basemind program for you on first use. The MCP-server and CLI paths need it installed yourself — see Install the program.
The plugin sets up everything for you — the server, the helper skills, the agent-comms features, and the slash commands. Pick your coding tool.
In the session (not your shell), run in order:
/plugin marketplace add Goldziher/basemind
/plugin install basemind@basemind
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.
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.
Optimized file search, semantic indexing, and persistent memory for Claude Code — with optional sync to a self-hosted web dashboard
Hand off context to any AI coding agent. Creates comprehensive handoff documents that capture the current task, progress, modified files, and all relevant context needed to seamlessly continue work in any AI assistant (Claude Code, Cursor, Copilot, Aider, etc.).
Persistent project memory for AI coding agents — semantic search, AST-aware chunking, dependency graphs, and conversation history
Local-first memory server — hybrid BM25+vector search, vault management, lint, and launchd lifecycle for project knowledge.