MCP ToolsWorkspace Management
remove_sketch_from_workspace
Remove a sketch from the active workspace, optionally deleting the `.genart` file from disk.
Input Schema
| Parameter | Type | Required | Description |
|---|---|---|---|
sketchId | string | yes | ID of the sketch to remove |
deleteFile | boolean | no | Also delete the .genart file from disk (default: false) |
Output Shape
{
"success": true,
"removedId": "noise-grid",
"removedFile": "noise-grid.genart",
"fileDeleted": false,
"sketchCount": 2
}Side Effects
- Modifies the
.genart-workspacefile (removes sketch reference and group memberships) - Removes the sketch from the editor state cache and selection
- If
deleteFileis true: deletes the.genartfile from disk
Error Cases
| Condition | Error |
|---|---|
| No workspace open | "No workspace is currently open" |
| Sketch not found in cache | "Sketch not found: 'bad-id'" |
| Sketch not in workspace | "Sketch 'bad-id' is not in the workspace" |
Golden Path Example
Request:
{
"sketchId": "noise-grid",
"deleteFile": false
}Response:
{
"success": true,
"removedId": "noise-grid",
"removedFile": "noise-grid.genart",
"fileDeleted": false,
"sketchCount": 2
}