pi-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.

Package details

← Back

extensionskill

Install pi-freecad from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:pi-freecad

Package: pi-freecad
Version: 0.1.1
Published: Mar 13, 2026
Downloads: 29/mo · 6/wk
Author: pierre-mike
License: MIT
Types: extension, skill
Size: 183.9 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "."
  ],
  "skills": [
    "./skill"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

🔧 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.