Commands Reference
Octodraw commands are registered in the command palette and exposed to local MCP automation. The command palette UI is opened with Ctrl+Shift+P; local automation lists commands through /scene/listCommands.
Runtime Source of Truth
Agents and scripts must discover command IDs at runtime:
curl http://127.0.0.1:8765/scene/listCommandsThe response contains id, name, category, description, icon, priority, and tags for each command available in that build.
Known Patterns
Current source and docs show these patterns:
- View commands:
view.selection,view.objects,view.object_info,view.model_settings,view.lighting,view.plugin_manager, camera commands, and capture UI commands. - Built-in tool commands:
tool.builtin.<tool-id-lowercase>. - Edit commands: grouping, ungrouping, reset-for-capture, voxel/architecture setup, and selected cut workflows.
- Export commands: screenshot, SVG view, IFC, and mesh export flows.
- Plugin commands:
<pluginId>.<commandId>. - Plugin tools:
tool.<pluginId>.<toolId>.
Regeneration Workflow
- Start Octodraw locally.
- Confirm MCP with
/mcp/status. - Fetch
/scene/listCommands. - Sort by category and ID.
- Compare generated command docs against hand-authored explanations.
- Keep generated snapshots separate from explanation text so stale output can be refreshed.
Generated Catalog
The table below is generated from the local MCP command catalog and kept separate from the prose in src/lib/data/generated/command_catalog.json.
84 commands Generated 5/5/2026, 9:25:01 PM Source /scene/listCommands
| ID | Name | Category | Description |
|---|---|---|---|
edit.cut_rect_hole | Edit> Cut Rect Hole | Edit | Cut a rectangular hole from selected faces using selected polyline |
edit.group | Edit> Group | Edit | Create object prototype from selection |
edit.new_architecture_group | Edit> Architecture: Wall Tool | Edit | Activate architecture modeling in the model root |
edit.new_voxel_group | Edit> New Voxel Group | Edit | Create a voxel group and enter edit mode |
edit.reset_scene_for_capture | Edit> Reset Scene For Capture | Edit | Reset scene and set perspective Y-up overview camera for screenshot automation |
edit.ungroup | Edit> Ungroup | Edit | Ungroup selected objects |
edit.voxelize_faces | Edit> Voxelize Faces | Edit | Voxelize selected faces into the active voxel model |
export.ifc_model | Export> IFC (Model) | Export | Export model geometry as IFC |
export.mesh | Export> Mesh (OBJ/STL/FBX/glTF/DAE/DXF/3MF/AMF/IFC) | Export | Export mesh geometry in selected format |
export.screenshot | Export> Screenshot | Export | Save a screenshot named after the current file with timestamp |
export.svg_view | Export> SVG (View) | Export | Export current view as SVG |
exporters.export.obj | Export> OBJ | Export | Export model as OBJ |
exporters.export.stl | Export> STL(ASCII) | Export | Export model as STL (ASCII) |
import.mesh | Import> Mesh (OBJ/STL/FBX/glTF/DAE/DXF/3MF/AMF/IFC) | Import | Import mesh geometry and place as object |
tool.builtin.arch_add_hole | Tool> Add Hole | Tools | Activate Add Hole tool |
tool.builtin.arch_door_frame | Tool> Door Frame | Tools | Activate Door Frame tool |
tool.builtin.arch_slab | Tool> Slab | Tools | Activate Slab tool |
tool.builtin.arch_stair | Tool> Stair | Tools | Activate Stair tool |
tool.builtin.arch_wall | Tool> Wall | Tools | Activate Wall tool |
tool.builtin.arch_window_frame | Tool> Window Frame | Tools | Activate Window Frame tool |
tool.builtin.circle | Tool> Circle | Tools | Activate Circle tool |
tool.builtin.construction_line | Tool> Construction Line | Tools | Activate Construction Line tool |
tool.builtin.copy_multiple | Tool> Copy Multiple | Tools | Activate Copy Multiple tool |
tool.builtin.cut_holes | Tool> Cut Holes | Tools | Activate Cut Holes tool |
tool.builtin.cut_holes_2 | Tool> Cut Holes 2 | Tools | Activate Cut Holes 2 tool |
tool.builtin.cut_out_3 | Tool> Cutout | Tools | Activate Cutout tool |
tool.builtin.extrude_swipe | Tool> Extrude Swipe | Tools | Activate Extrude Swipe tool |
tool.builtin.face_outline | Tool> Face Outline | Tools | Activate Face Outline tool |
tool.builtin.helical_array | Tool> Helical Array | Tools | Activate Helical Array tool |
tool.builtin.helical_array_equalized | Tool> Helical Array Even | Tools | Activate Helical Array Even tool |
tool.builtin.helicoidal_rotate_multiple | Tool> Helicoidal Rotate Multiple | Tools | Activate Helicoidal Rotate Multiple tool |
tool.builtin.line | Tool> Line | Tools | Activate Line tool |
tool.builtin.line_offset | Tool> Line Offset | Tools | Activate Line Offset tool |
tool.builtin.linear_dimension | Tool> Linear Dimension | Tools | Activate Linear Dimension tool |
tool.builtin.mesh_intersection | Tool> Mesh Intersection | Tools | Activate Mesh Intersection tool |
tool.builtin.move | Tool> Move | Tools | Activate Move tool |
tool.builtin.paint | Tool> Paint | Tools | Activate Paint tool |
tool.builtin.planar_rotate_multiple | Tool> Planar Rotate Multiple | Tools | Activate Planar Rotate Multiple tool |
tool.builtin.planar_translate_multiple | Tool> Planar Translate Multiple | Tools | Activate Planar Translate Multiple tool |
tool.builtin.plane_section | Tool> Plane Section | Tools | Activate Plane Section tool |
tool.builtin.push_pull | Tool> Push/Pull | Tools | Activate Push/Pull tool |
tool.builtin.quad | Tool> Quad | Tools | Activate Quad tool |
tool.builtin.rectangle | Tool> Rectangle | Tools | Activate Rectangle tool |
tool.builtin.rotate | Tool> Rotate | Tools | Activate Rotate tool |
tool.builtin.rotate_2 | Tool> Rotate 2 | Tools | Activate Rotate 2 tool |
tool.builtin.rotate_stretch | Tool> Rotate Stretch | Tools | Activate Rotate Stretch tool |
tool.builtin.rotational_array | Tool> Rotational Array | Tools | Activate Rotational Array tool |
tool.builtin.rotational_array_equalized | Tool> Rotational Array Even | Tools | Activate Rotational Array Even tool |
tool.builtin.scale | Tool> Scale | Tools | Activate Scale tool |
tool.builtin.select | Tool> Select | Tools | Activate Select tool |
tool.builtin.stretch | Tool> Stretch | Tools | Activate Stretch tool |
tool.builtin.surface_rectangle | Tool> Surface Rect | Tools | Activate Surface Rect tool |
tool.builtin.text | Tool> Text | Tools | Activate Text tool |
tool.builtin.vector_text | Tool> Vector Text | Tools | Activate Vector Text tool |
tool.builtin.volumetric_translate_multiple | Tool> Volumetric Translate Multiple | Tools | Activate Volumetric Translate Multiple tool |
tool.builtin.voxel | Tool> Voxel | Tools | Activate Voxel tool |
tool.builtin.voxel_frame | Tool> Voxel Frame | Tools | Activate Voxel Frame tool |
tool.builtin.voxel_volume | Tool> Voxel Volume | Tools | Activate Voxel Volume tool |
tool.vector_text | Tool> Vector Text | Tools | Activate vector text tool |
view.architecture_settings | View> Architecture Settings | View | Show architecture settings panel |
view.axis_guide | View> Add Axis Guide | View | Add axis helper at cursor snap |
view.camera.orbit | View> Camera Orbit | View | Switch to perspective orbit camera |
view.camera.orthographic | View> Camera Orthographic | View | Switch to orthographic camera |
view.camera.walkthrough | View> Camera Walkthrough | View | Switch to perspective walkthrough camera |
view.capture_ui_minimal | View> Capture UI Minimal | View | Hide floating panels and palette for cleaner screenshots |
view.capture_ui_restore | View> Capture UI Restore | View | Restore normal floating panel behavior after capture mode |
view.grid_guide | View> Add Grid Guide | View | Add grid helper at cursor snap |
view.help_about | View> Help / About | View | Show help and platform notes panel |
view.hotspot_settings | View> Hotspot Settings | View | Show hotspot settings panel |
view.hvac_settings | View> HVAC Settings | View | Show HVAC settings panel |
view.lighting | View> Lighting | View | Show lighting panel |
view.model_settings | View> Model Settings | View | Show model settings panel |
view.object_info | View> Object Info | View | Show object info panel |
view.objects | View> Objects | View | Toggle object prototypes panel |
view.ortho.back | View> Ortho Back | View | Switch to orthographic back view |
view.ortho.bottom | View> Ortho Bottom | View | Switch to orthographic bottom view |
view.ortho.front | View> Ortho Front | View | Switch to orthographic front view |
view.ortho.left | View> Ortho Left | View | Switch to orthographic left view |
view.ortho.right | View> Ortho Right | View | Switch to orthographic right view |
view.ortho.top | View> Ortho Top | View | Switch to orthographic top view |
view.plugin_manager | View> Plugin Manager | View | Show plugin manager panel |
view.polyline_settings | View> Polyline Settings | View | Show polyline settings panel |
view.selection | View> Selection | View | Show selection panel |
view.vector_text_settings | View> Vector Text Settings | View | Show vector text settings panel |