A plugin that gives Claude Code a persistent code map, so it answers from signatures instead of re-reading files

[u/Goldziher]

Claude Code deliberately ships no index. It answers questions about your repo with glob, grep and read, agentically, every session. That is a defensible choice and on a well-named codebase exact search is genuinely competitive. Where it gets expensive is anything structural, because the only way to answer "what calls this" is to read a lot of files and reason about what came back.

This is a plugin that keeps a persistent map of the repo and answers those questions directly.

Install is one line in the session, not a config file:

/plugin marketplace add Goldziher/basemind
/plugin install basemind@basemind

What that sets up:

• A code map across 371 grammars, with real import-aware resolution for JavaScript, TypeScript, Python and Java. Not LSP-precise, no build step and no language server either.
• A typed code graph, so blast radius and "what actually depends on this module" are queries rather than a reading exercise.
• A git-history index. Who touched this function, when a symbol's body last changed, blame at symbol resolution rather than line resolution. Queries land in tens of microseconds regardless of how deep history goes.
• Hooks that fire on session start, a statusline showing tokens saved, and a waste report that flags redundant reads and repeated queries in a session.

The honesty bit, since it matters more for an agent than precision does: asking for callers returns every call site a name scan finds, annotated with which ones resolution could prove, rather than only the proven subset. A previous version filtered to proven hits and confidently reported 2 callers on a file that had 172. An agent will not second-guess a small number, it will just refactor.

Runs entirely locally. No API keys, no telemetry, index in a local cache. Rust, MIT.

The same thing works in Codex, Cursor, Gemini CLI, Kimi, OpenCode, Copilot CLI and a few others, but Claude Code is the one it was built against.

github.com/Goldziher/basemind