Use Workspace
use_workspaceClaims or creates an isolated workspace and targets later tool calls to it, keeping FreeCAD documents and handles separate. Use unique workspaces for concurrent agents.
Instructions
Claim (creating if needed) an isolated workspace and make it the target of subsequent tool calls. Each workspace is its own freecadcmd process with its own ActiveDocument and handle registry — handles do NOT cross workspaces.
The selection is SERVER-WIDE: it retargets every client sharing this server,
including other subagents of the same session. Concurrent agents must instead
pass workspace=<unique name> on every tool call, which pins just that call
and leaves this selection alone.
The pool is capped (ANKUSDRIVE_MAX_WORKSPACES, default 4) and idle workspaces are reaped (ANKUSDRIVE_WORKSPACE_IDLE_S, default 900s); claiming a workspace beyond a full pool raises — close an idle one first. Pass "default" to return to the baseline single-agent workspace. Returns {workspace: , freecad: [...], workspaces: [names]}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "use_workspace"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| workspace | No | Run this call in this named workspace |