[solution]
Retargets the resident index at a workspace root, rebuilding the lexical and structural tiers before returning, and answers with the new server_status. Use it to point one long-lived server at a git worktree without a restart. A root outside the started root's family needs acknowledge: true, because repointing widens the file sandbox. Pass semantic: true or false to opt the embedding tier in or out for this root; omitted, it follows the server's --semantic default.
The index normally maintains itself; explicit control matters only after bulk changes outside the watcher.
The model can force a re-scan after large generated changes instead of wondering whether results are stale.
| Name | Type | Required | Description |
|---|---|---|---|
| root | string | Yes | Absolute path to the workspace root to index. |
| acknowledge | boolean | No | Allow a root outside the server's home family (a widened sandbox). Default false. |
| semantic | boolean | No | Turn the embedding (semantic) tier on or off for this root. Omitted follows the server's --semantic default; enabling it may download the model once, and the tier warms in the background. |
Point the server at a git worktree
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "load",
"arguments": {
"root": "/repo/.claude/worktrees/feature"
}
}
}Returns the new server_status: root, indexed files, watcher and tier health. meta.generation increments on each repoint.