# basemind
> The context and communication layer for coding agents. basemind turns any repository into an
> always-current map of its code, documents, git history, and shared memory — served over MCP — so
> agents answer from structure and search instead of spending their context window on `grep` and file
> reads. One server also gives a team of agents a shared channel to coordinate while they work.
basemind is a pure-Rust, content-addressed, Fjall + LanceDB-backed index. It pre-parses a repo with
tree-sitter across 300+ languages and exposes a structured code map (outlines, symbol search,
references, callers, call graphs, implementations), git history + blame at symbol resolution,
full-text + semantic document search over 90+ formats (with OCR and cross-encoder reranking), shared
per-repo memory, on-demand web crawl, and an agent-to-agent comms broker. Every tool returns paths,
line numbers, and signatures — not file bodies — so a structural answer costs a fraction of the
tokens of reading source. The operating rule for agents: **basemind first, shell/grep/git fallback.**
## Capabilities
- [Code search](skills/basemind-code-search/SKILL.md): Find where code is defined and used — symbol search, file outlines, references, callers, call graphs, implementations, dependents, indexed regex (`search_symbols`, `outline`, `find_references`, `find_callers`, `call_graph`, `find_implementations`, `dependents`, `workspace_grep`).
- [Git history](skills/basemind-git-history/SKILL.md): Recent commits, commits touching a path, per-line and per-symbol blame, structural diffs across revisions, churn ranking, symbol history, and full-text search over commit authors + messages (`recent_changes`, `commits_touching`, `blame_file`, `blame_symbol`, `diff_file`, `diff_outline`, `hot_files`, `symbol_history`, `search_git_history`).
- [Document search](skills/basemind-documents/SKILL.md): Semantic + full-text search over PDFs, Office, HTML, email, and images (OCR) plus scraped/crawled web pages, with reranking, keyword and named-entity filters, and per-document summaries (`search_documents`, `web_scrape`, `web_crawl`, `web_map`, `memory_*`).
- [Agent comms](skills/basemind-comms/SKILL.md): Coordinate with other agents on the same repo via scoped rooms, a per-agent inbox, and two-tier messages (`room_post`, `room_history`, `inbox_read`, `message_get`, `dm_send`, `agent_list`).
## Skills
- [basemind](skills/basemind/SKILL.md): Umbrella overview of the whole indexed context layer and tool-routing table.
- [basemind-code-search](skills/basemind-code-search/SKILL.md): Navigate code without reading files.
- [basemind-git-history](skills/basemind-git-history/SKILL.md): Git intelligence over the index.
- [basemind-documents](skills/basemind-documents/SKILL.md): Document RAG and web ingestion.
- [basemind-comms](skills/basemind-comms/SKILL.md): Agent coordination over the broker.
- [basemind-cli](skills/basemind-cli/SKILL.md): The scriptable CLI surface, at parity with the MCP tools.
- [basemind-scan](skills/basemind-scan/SKILL.md): Build or refresh the index with `basemind scan`.
- [basemind-doctor](skills/basemind-doctor/SKILL.md): Diagnose and recover basemind when it isn't working.
- [basemind-stats](skills/basemind-stats/SKILL.md): Session usage dashboard and estimated tokens saved.
- [multi-agent-room](skills/multi-agent-room/SKILL.md): Orchestrate a team of named subagents in a shared room.
## Documentation
- [README](README.md): Installation, feature overview, how it works, performance, and CLI reference.
- [CHANGELOG](CHANGELOG.md): Release history and schema-version bump notes.
- [CLAUDE.md](CLAUDE.md): Project rules, crate layout, and conventions for agents working in the repo.
## Optional
- [Config schema](schema/basemind-config-v1.schema.json): JSON Schema for `.basemind/basemind.toml`.
- [Cargo.toml](Cargo.toml): Crate manifest and feature flags (`documents`, `memory`, `crawl`, `comms`, `full`).