SwpilotCLI

Get information about the currently open SolidWorks document (part, assembly, or drawing). Use when you need to check document properties, file path, document type, or current state without modifying it.

YOUR EYES. Use this tool whenever you need to see the screen — do NOT say you cannot see or take screenshots. Run this first, then use the Read tool on ./temp/screenshot/screenshot.png to view the image. Use when: user asks what is on screen, you want to verify code execution results, or you need visual context before deciding next steps.

"[ActionGroup] Batch replace text inside Note annotations across all SolidWorks drawings (.slddrw) in a specified folder (root only)." For each drawing, opens it silently, finds all Notes containing the search text, replaces every occurrence, saves a copy with a custom suffix to a specified output folder, then closes the original without saving. Reports which files were changed and how many notes were replaced per file. Use when you need to find-and-replace note text across multiple drawings in one shot.

Batch convert Parasolid `.x_t` and `.xt` files in a specified folder to STEP `.step` files in the same folder. Scans the folder root only, creates same-name `.step` outputs, suppresses template-selection prompts by forcing default part templates, and closes each temporary import document after export. Use when you need one-shot XT to STEP conversion for a local folder.

Scan all dimensions in the active SolidWorks drawing and report which ones are dangling (unattached). Lists every dimension with its type, value, and name, marking dangling ones with [!]. Outputs a summary count at the end. Use before running a repair tool, for QC checks before release, or whenever you need to know if a drawing has dangling annotations.

Close SolidWorks document(s). Supports three modes via argument: no argument or "nosave" closes the active document without saving; "save" silently saves then closes the active document (if file has never been saved, forces close without saving); "all" closes every open document without saving. Use when the user wants to close the current file, close and save, or close everything.

Delete all orphaned sketches in the active SolidWorks part — sketch features not absorbed by any extrusion, cut, or other parent feature. Iterates the feature tree, removes every top-level `ProfileFeature`, then rebuilds. Use for cleanup after discarded geometry experiments, or to remove leftover construction sketches before saving.

Diagnose whether candidate sketch points belong to the same rigid body in the active SolidWorks sketch. Compares point movement and pairwise distances between two nearby dimension states. Use before computing IC when you need to verify that your tracked points are valid on the same body.

Batch export all unique parts (.sldprt) in the active SolidWorks assembly to Parasolid (.x_t) format. Outputs all files to an "xt/" subfolder next to the assembly. Use when you need to convert an entire assembly's parts to XT in one operation.

Export a single SolidWorks part (.sldprt) to Parasolid (.x_t) format. Uses the active document if no path is given. Accepts optional part path and output directory arguments. Use for single-part export or as the per-item step in LLM-orchestrated batch workflows.

Apply an angle-distance chamfer to circular hole edge(s) in the active SolidWorks part. Targets full circular edges by diameter and can optionally limit selection to the nearest matching edge to a supplied world coordinate. Use for chamfering drilled/cut hole openings such as 0.5 C x 45 deg center-hole chamfers.

Extrude the active sketch outward to create a Boss-Extrude solid feature. Must be called while a sketch is active in editing mode. Use after sketch-on-face + sketch-draw to build up solid geometry.

Cut-extrude the active sketch through the solid to remove material. Supports a fixed depth in mm or through-all. Must be called while a sketch is active in editing mode. Use after sketch-on-face + sketch-draw to create holes, pockets, or slots.

Create a HoleWizard ISO Straight Tap feature on a specified face at one or more positions. Selects the face programmatically by world coordinates — no manual pre-selection required. Supports any metric size (M3–M12), blind depth in mm, or through-all. Use when the user asks to add tapped holes, M-size threaded holes, or straight taps to a face.

Full attribute diagnostic tool for the active SolidWorks drawing. Dumps every annotation's complete properties: for dimensions — name, value, type, text parts (prefix/suffix/callout), tolerance type and values, precision, arrow style, layer, color; for notes — text content, leader attach point, arrow count and style, angle, layer, color. Also lists all visible geometry vertices with both model and sheet coordinates. Use when debugging dangling repairs, auditing annotation attributes before migration, or understanding drawing geometry for automation development.

Inspect the active SolidWorks sketch setup. Reports the active document, selected objects, features, sketch points, and sketch segments for the current sketch. Use when validating manually drawn IC construction geometry or debugging sketch topology before automation.

List all unique part files (.sldprt) referenced by the active SolidWorks assembly. Outputs a JSON array of full file paths. Use this to preview parts before batch processing, or to get part paths for further automation.

List every face of every solid body in the active SolidWorks part, printing each face's surface normal and bounding-box centroid in millimetres. Use as a pre-selection scan before `sketch-on-face` or `feature-hole-wizard-straight-tap`, or when you need to identify a target face by coordinates without manually probing the model.

List features in the active SolidWorks document's Feature Tree, printing each feature's type and name. Walks from `FirstFeature()` via `GetNextFeature()`. Accepts an optional integer argument to limit output count (default: all features). Use to locate named reference planes, inspect feature order, or find features by name before operations like `move-rollback-bar`, `sketch-on-face`, or deletion.

Move the SolidWorks Rollback Bar to a specified feature position. Use this to suppress features by moving the rollback bar before or after any feature in the Feature Tree.

Create a new SolidWorks Part document using the user's configured default Part template. Reads `swDefaultTemplatePart` from user preferences and calls `NewDocument`. Use when the user asks to create a new part, start modeling from scratch, or needs a fresh `.sldprt` to host a subsequent sketch/feature workflow.

Open a SolidWorks document (.sldprt, .sldasm, .slddrw) by file path and activate it. Requires a file path argument. Use when the user wants to open a specific file in SolidWorks.

Draw the two perpendicular bisectors and IC intersection for the validated 68 to 68.01 mm example. Reads precise source geometry from 草圖1 and draws the bisectors into 草圖5. Use when explaining how the 68 mm IC is constructed geometrically.

Plot the current validated IC coordinate list into the active SolidWorks sketch as fixed sketch points. Use when you already have the approved IC coordinate sequence for this mechanism and want to visualize the path directly in the sketch.

Plot the validated P0, P1, midpoint, and short P0-P1 chord used in the 68 to 68.01 mm IC explanation. Draws into 草圖5. Use when you need to show exactly which two positions define the perpendicular bisector construction.

Engineering drawing / hand-sketch interpretation protocol. MUST be executed before any feature modeling whenever the user provides an engineering drawing or hand-drawn sketch image. Enforces multi-view cross-reference and isometric priority to prevent geometric misinterpretation.

Find and replace text inside all Note annotations in the active SolidWorks drawing. Requires two arguments: the text to find and the replacement text. Scans every sheet and view, replaces all matching notes, and reports how many were changed. Use as an atomic building block in LLM-orchestrated batch workflows (e.g. open-doc → replace-note-text → save-drawing-as-copy → close-doc). Does NOT save the file — caller is responsible for saving or discarding.

Save a SolidWorks drawing (.slddrw) as a copy to a new file path, without changing the original document's path or closing it. Requires two arguments: source drawing path and output path. Use when you need to duplicate a drawing under a new name or location while keeping the original open and unmodified. Useful as a building block in LLM-orchestrated batch rename/copy workflows.

Save the active SolidWorks drawing to a different format. Exports to the same directory as the drawing file with the same filename and a new extension. Supported formats: pdf, png, jpg, tif, dwg, dxf, ai, psd, edrw, html, slddrw. Default format is pdf if no argument is given. Optionally accepts a second argument to override the output file path. Use when you need to export or convert the current drawing to another format.

Set the value of a driving dimension in the active SolidWorks document by its full name. Requires two arguments, the dimension full name (e.g. `D1@Sketch1` or `D1@Boss-Extrude1`) and the new value in millimetres. Calls Parameter().SetSystemValue3 then rebuilds. Use as an atomic building block whenever you need to change a sketch or feature dimension, regardless of what that dimension drives (hole radius, extrude depth, rectangle length, etc.).

Set view orientation of the active SolidWorks document. Supported views: front, back, left, right, top, bottom, iso (default), dimetric, trimetric. Calls ShowNamedView2 + ViewZoomtofit2.

Draw sketch geometry in the active SolidWorks sketch from a JSON SketchPlan. Supports line, circle, arc, ellipse. Auto-infers H/V on lines and COINCIDENT on shared endpoints. Applies anchor, explicit relations, and dimensions. Does NOT exit the sketch. Call swpilotcli-sketch-exit only when explicitly asked to commit or exit the sketch. Use when the user asks to draw a sketch, reproduce a shape, or add geometry to an open sketch.

Exit the active SolidWorks sketch and report its constraint status (Fully Defined / Under-Constrained / Over-Constrained). Call this after swpilotcli-sketch-draw to commit geometry and check if the sketch is fully constrained.

Open a new sketch on a specified face or plane. Accepts either a named plane (e.g. 前基準面) or world face coordinates in mm (e.g. 25,10,-20). Enters sketch editing mode and stays there — follow up with sketch-draw to draw geometry, then extrude-boss or extrude-cut.

Sweep the validated driving dimension in the active SolidWorks sketch and print the computed IC coordinates for each step. Uses the current Yeti 6-bar point tracking method validated in this session. Use when you need the IC path as coordinates before plotting points.