list_sketches

Scan the workspace directory for all `.genart` files, returning metadata summaries regardless of whether they are referenced in the active workspace.

Input Schema

Parameter	Type	Required	Description
`directory`	string	no	Directory to scan (default: workspace directory)
`recursive`	boolean	no	Scan subdirectories (default: `false`)
`includeUnreferenced`	boolean	no	Include files not in the active workspace (default: `true`)

Output Shape

{
  "success": true,
  "directory": "/absolute/path/to/workspace",
  "sketches": [
    {
      "id": "noise-grid",
      "title": "Noise Grid",
      "renderer": "p5",
      "canvas": { "width": 1200, "height": 1200 },
      "parameterCount": 4,
      "colorCount": 3,
      "path": "/absolute/path/to/noise-grid.genart",
      "inWorkspace": true,
      "modified": "2026-02-14T12:00:00Z"
    }
  ],
  "total": 5,
  "inWorkspace": 3,
  "unreferenced": 2
}

Side Effects

None. Read-only filesystem scan.

Error Cases

Condition	Error
No workspace open and no directory specified	`"No workspace is currently open and no directory specified"`
Directory does not exist	`"Directory does not exist: '/bad/path'"`

Golden Path Example

Request:

{
  "recursive": false,
  "includeUnreferenced": true
}

Response: (as shown in Output Shape above)