Check connection health, addon protocol version, FreeCAD PID, and dispatch status.

List all open FreeCAD documents (active_document, count, and documents list).

Inspect the feature tree, dependencies, error messages, UI edit state, and TNP warnings.

Args: doc_name: Document name; empty string uses the active document. include_properties: Keep False (default) for a compact graph; set True for all properties.

Dump all properties, validity state, error description, and shape metadata for one object.

Inspect face/edge topology, bounding box, volume, and validity (optional OCC BOPCheck).

Args: name: Object name in the document. deep_check: Set True to run OCC's slower deep Shape.check(True) BOP validity test. doc_name: Target document name (empty string uses ActiveDocument).

Find EdgeN names on a shape matching direction ('X'/'Y'/'Z'/'+Z'/'-Z'), length, or location.

Find FaceN names on a shape matching normal ('+Z', '-Z', 'X'), area, surface type, or point.

Measure minimum 3D distance and delta vector between two objects or Face/Edge/Vertex refs.

Inspect Sketch DoF, OpenVertices, missing/conflicting/redundant constraints, and tutor hints.

Recompute the document and report new, resolved, and persistent object errors.

Read recent lines from FreeCAD's Report view / console log (1-1000 lines).

Read recent student/model events recorded by the FreeCAD observer (edits, undos, dialogs).

Translate a cryptic FreeCAD/OpenCASCADE error message into beginner causes and fixes.

Search live FreeCAD commands for menu paths, toolbars, shortcuts, and why a button is greyed out.

Args: query: Keyword such as 'Pad', 'Fillet', 'Sketch', or 'TechDraw'. workbench_filter: Optional command prefix filter (e.g. 'PartDesign', 'Sketcher'). limit: Max results (1-50).

Put a temporary, click-through visual spotlight on a FreeCAD button, menu, panel, or workbench selector.

Args: target: Command name (e.g. 'PartDesign_Pad'), button label ('Pad'), or panel name ('Model', 'Tasks', 'Report view', 'Workbench'). label: Optional short callout text shown next to the highlight frame. duration_s: Auto-dismiss time in seconds (1.0-20.0). clear: Set True to immediately remove any active highlight.

List all FreeCAD workbenches and show which one is currently active.

Switch FreeCAD's active workbench (e.g., 'PartDesignWorkbench', 'PartWorkbench', 'TechDrawWorkbench').

Get objects and sub-elements (Face1, Edge2, etc.) currently selected by the user in FreeCAD.

Highlight/select objects or sub-elements (e.g. ['Pad', 'Pad.Face1']) in FreeCAD's viewport.

Orient and zoom the 3D camera (Isometric, Front, Top, Right, Back/Rear, Left, Bottom) without screenshot.

Capture the 3D viewport (capture_scope='viewport') or full FreeCAD window ('window') as PNG.

Args: view_name: 'Current', 'Isometric', 'Front', 'Top', 'Right', 'Back', 'Left', 'Bottom', 'Dimetric', or 'Trimetric'. width: Optional explicit image width (auto-scaled <=1024px viewport / <=1280px window). height: Optional explicit image height. focus_object: Optional object name to zoom/fit before capturing. capture_scope: 'viewport' for clean 3D render, or 'window' to include Task panels, Combo View, and dialogs.

Create a new FreeCAD document (defaults to a safe 'Tutor_Demo' scratch file for demonstrations).

Save an open document to its existing .FCStd path or a new destination path.

Open a .FCStd file (or import a .step/.stp/.iges/.igs file into a new document).

Close a document safely (refuses if modified unless save_before_close or discard_unsaved is True).

Export Bodies or solids to .step/.stp, .stl, .obj, .3mf, .iges, or .brep.

Undo the most recent FreeCAD transaction.

Redo the most recently undone FreeCAD transaction.

Check available undo/redo steps and transaction names.

Create a PartDesign::Body container (undoable).

Create a Sketcher::SketchObject on an Origin plane or face (undoable).

Add/edit/delete Sketch geometry & constraints with automatic Coincident/H/V constraining (undoable).

Extrude a Sketch inside a PartDesign Body using Pad (undoable; rolls back if invalid).

Cut material from a PartDesign Body using Pocket (undoable; rolls back if invalid).

Hollow out a PartDesign solid by opening selected faces and setting wall thickness (undoable).

Drill parametric simple, counterbore, countersink, or threaded holes from a Sketch (undoable).

Revolve a Sketch around an axis to add solid material in PartDesign (undoable).

Revolve a Sketch around an axis to subtract/cut material in PartDesign (undoable).

Loft between two or more Sketches (AdditiveLoft or SubtractiveLoft) (undoable).

Sweep a profile Sketch along a spine path (AdditivePipe or SubtractivePipe) (undoable).

Mirror PartDesign feature(s) across a plane (PartDesign::Mirrored) (undoable).

Repeat PartDesign feature(s) along a line (PartDesign::LinearPattern) (undoable).

Repeat PartDesign feature(s) around an axis (PartDesign::PolarPattern) (undoable).

Taper selected solid faces by a draft angle (PartDesign::Draft) (undoable).

Create a PartDesign::Plane Datum Plane inside a Body (TNP-safe sketch plane) (undoable).

Create a FreeCAD 1.0/1.1 App::VarSet parametric variable table (undoable).

Update a Data-tab property (Pad.Length, Fillet.Radius, VarSet fields) or bind an expression (undoable).

Set object Visibility, Transparency (0-100), or ShapeColor [r, g, b] in the View tab (undoable).

Create a Part CSG primitive ('Box', 'Cylinder', 'Sphere', or 'Cone') (undoable).

Run a Part CSG Boolean ('Fuse', 'Cut', or 'Common') between two objects (undoable).

Round selected edges (e.g. ['Edge1', 'Edge2']) on a feature or shape (undoable).

Bevel selected edges (e.g. ['Edge1']) on a feature or shape (undoable).

Create a TechDraw 2D drawing sheet with an SVG template (undoable).

Add an orthographic view or multi-view Projection Group to a TechDraw page (undoable).

Add a 2D TechDraw dimension (Distance, Radius, Diameter, Angle) referencing view edges/vertices (undoable).

Add a TechDraw cross-section view (DrawViewSection) cutting through a BaseView (undoable).

Export a TechDraw drawing page to PDF or SVG.

Execute Python inside FreeCAD's main thread (escape hatch; undoable when wrap_transaction=True).