unload

[solution]

Drops the current workspace and frees its in-RAM index and file watcher. server_status still answers, reporting the unloaded state. Idempotent.

Why this tool exists

The index normally maintains itself; explicit control matters only after bulk changes outside the watcher.

How it helps the agent

The model can force a re-scan after large generated changes instead of wondering whether results are stale.

This tool requires no parameters.

Examples

Free the resident index

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "unload",
    "arguments": {}
  }
}

Response Notes

Returns root: null and loaded: false. meta.generation increments.

↑/↓ NavigateEnter OpenSpace Expand