🔧 FreeCAD

Drive FreeCAD from pi with natural language. Create 3D shapes, open and modify .FCStd files, export to STEP/IGES/STL/DXF, and batch-convert entire folders — all without leaving the terminal.

Install

pi install npm:pi-freecad

Requirements

• FreeCAD installed at /Applications/FreeCAD.app (macOS). The Python environment is fully self-contained inside the app bundle — no extra setup required.

What it does

Registers five tools that wrap the FreeCAD Python agent. The agent runs headlessly via the bundled freecad_run.sh shell script and communicates results back to pi.

Tools

| Tool | Description | |---|---| | freecad_capabilities | Show what the FreeCAD agent can do and confirm FreeCAD is available | | freecad_prompt | Execute a natural language CAD command, e.g. Create a box 100x50x25 | | freecad_create | Create a basic 3D shape (box, cylinder, sphere) and save to a .FCStd file | | freecad_export | Open an existing .FCStd file and export it to STEP, IGES, STL, DXF, or PDF | | freecad_batch | Batch-process all .FCStd files matching a glob pattern in a directory |

Examples

Create a cylinder with radius 30 and height 80
Export /models/part.FCStd to STEP
Batch export all .FCStd files in /models/ to STL

Bundled skill

The extension ships with a skill/SKILL.md and supporting agent configuration that is automatically loaded into the session. It includes rules for CAD engineering best practices, export formats, marine engineering patterns, and FreeCAD Python scripting.