basemind-scan

# basemind-scan — build or refresh the index (no MCP server required) basemind answers code-map questions from an index in a machine-global cache (Linux `~/.local/share/basemind/`, macOS `~/Library/Application Support/basemind/`; override `BASEMIND_DATA_HOME`), keyed by workspace. That index is built by `basemind scan`. This skill runs the scan via the **CLI**, so it works even when the MCP server (`basemind serve`) is not running — which is exactly the situation when basemind reports **"no index"** or **"no indexed files"**, or when MCP tools aren't loaded in the session. ## When to use - basemind / the statusline reports **no index** for this repo. - An MCP tool returns "no indexed files" or empty results that should not be empty. - The MCP server isn't running or isn't reachable, and you need the code map. - The index is stale after large changes and you want a full rebuild. ## How to run From the repository root: ```sh basemind scan # full working-tree scan basemind scan <path> # scope to a path (incremental) ``` Finding the binary (in order of preference): 1. `basemind` on `PATH`. 2. The plugin-managed binary the MCP launcher caches: `${XDG_CACHE_HOME:-~/.cache}/basemind/bin/<version>/basemind`. 3. A dev build: `cargo build --release` then `./target/release/basemind scan`. ## Notes - The scan writes the content-addressed blob store + Fjall inverted index into the machine-global cache (never inside the repo). Seconds for small repos; ~22 s fo...