Tools
shutdown_workspace
Deactivate a workspace and release its language-server and watcher resources.
shutdown_workspace deactivates an active workspace, stops its language servers and file watchers, and releases workspace-specific analysis resources.
Use when
- You are finished with a secondary workspace and want to free memory, CPU, and operating-system resources.
Do not use when
- You still need semantic tools for that workspace.
- You only need to restart language servers while preserving workspace state.
Request
{"workspace_root":"/absolute/path/to/repository"}Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace_root | string | Yes | Absolute workspace root directory or a file:// URI. |
What it returns
The workspace is deactivated, its language servers and file watchers are stopped, and its workspace-specific analysis resources are released.
Common mistakes
- Shutting down a workspace before finishing semantic work against it.
- Passing a relative path or a nested source directory instead of the workspace root.
- Assuming shutdown preserves a live workspace session; initialize it again when needed.
Related tools
initialize_workspaceactivates a workspace in the current session.restart_workspacerestarts running servers while preserving workspace state.