Cli Anything Freecad

by hkuds34f519533bc1No license51K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 2 weeks ago

Complete CLI harness for FreeCAD parametric 3D CAD modeler (258 commands). Covers ALL workbenches: Part (29 primitives + boolean + mirror + loft + sweep), Sketcher (26 cmds: geometry + constraints + editing), PartDesign (38 cmds: pad/pocket/groove/fillet/chamfer/patterns/hole/datum), Assembly (11 cmds), Mesh (16 cmds), TechDraw (15 cmds: views + dimensions + PDF/SVG), Draft (33 cmds: 2D shapes + arrays + transforms), FEM (12 cmds), CAM/CNC (10 cmds), Surface (6 cmds), Spreadsheet (7 cmds), Import (13 formats), Export (17 formats), Measure (12 cmds), Materials (21 presets). Headless FreeCAD export to STEP/IGES/STL/OBJ/DXF/PDF/glTF/3MF.

Instructions onlyDesign & Creative
AI-generated overview

CLI harness for FreeCAD parametric 3D CAD, exposing 258 commands across workbenches for modeling, export and preview.

What it does
Provides a command-line interface to the FreeCAD parametric 3D CAD modeler, organized into 17 command groups covering Part, Sketcher, PartDesign, Assembly, Mesh, TechDraw, Draft, FEM, CAM, Surface, Spreadsheet, materials, measurement, import and export. It creates and edits CAD documents and geometry, runs boolean and feature operations, generates technical drawings and G-code, and exports to formats such as STEP, IGES, STL, OBJ, DXF, PDF, glTF and 3MF. It also offers preview capture, live preview sessions and motion video rendering, with JSON output for agent use.
When to use it
Use it when an agent needs to build or modify parametric 3D CAD models, run CAD operations such as booleans, fillets or patterns, or produce engineering drawings and mesh/CAD exports. It also suits iterative modeling loops that need visual preview verification or rendered showcase videos.
Requirements
FreeCAD must be installed with freecadcmd available in PATH. The harness is installed via pip from the freecad/agent-harness package. It ships no scripts of its own; commands are invoked through the cli-anything-freecad CLI, and preview viewing uses cli-hub. No credentials are mentioned.

cli-anything-freecad

Complete CLI harness for FreeCAD — 258 commands across 17 groups covering ALL workbenches.

Prerequisites

FreeCAD must be installed: freecadcmd must be in PATH.

Installation

bash
pip install -e freecad/agent-harness

Basic Usage

bash
cli-anything-freecad --json <command>           # JSON output for agentscli-anything-freecad --json -p proj.json <cmd>  # With project filecli-anything-freecad                            # Interactive REPL

Preview, Live Preview, and Motion

FreeCAD is currently the deepest preview integration in this branch.

Preview commands:

bash
# List preview recipescli-anything-freecad --json -p proj.json preview recipes
# Capture a real 4-view bundlecli-anything-freecad --json -p proj.json preview capture --recipe quick
# Start poll-mode live previewcli-anything-freecad --json -p proj.json preview live start --recipe quick --mode poll --source-poll-ms 500
# Query current live state without renderingcli-anything-freecad --json -p proj.json preview live status --recipe quick
# Stop live preview publicationcli-anything-freecad --json -p proj.json preview live stop --recipe quick

Typical quick bundle artifacts:

  • hero.png
  • front.png
  • top.png
  • right.png

Live preview persists:

  • session.json
  • immutable bundle directories
  • trajectory.json

preview live status --json is intended for agents and includes a compact trajectory_summary in addition to _session_dir, current bundle refs, and _trajectory_path.

Viewer commands:

bash
cli-hub previews inspect /path/to/bundle-or-sessioncli-hub previews html /path/to/bundle-or-session -o page.htmlcli-hub previews watch /path/to/session --opencli-hub previews open /path/to/bundle-or-session

Motion commands remain separate from preview and are used for final truthful frame rendering and showcase videos:

bash
cli-anything-freecad --json -p proj.json motion new --name spin --duration 6 --fps 24cli-anything-freecad --json -p proj.json motion keyframe spin --time 0.0 --part 0 --position 0,0,0cli-anything-freecad --json -p proj.json motion render-video spin output.mp4

Command Groups (258 commands)

document (5) — Document management

bash
cli-anything-freecad --json document new --name "Part" -o proj.jsoncli-anything-freecad --json document new --profile print3d -o proj.jsoncli-anything-freecad --json -p proj.json document infocli-anything-freecad --json -p proj.json document save -o copy.jsoncli-anything-freecad --json document profiles

part (29) — 3D primitives, boolean, transforms, operations

bash
# Primitives: box, cylinder, sphere, cone, torus, wedge, helix, spiral, thread, plane, polygon_3dcli-anything-freecad --json -p p.json part add box -P length=20 -P width=15 -P height=5cli-anything-freecad --json -p p.json part add cylinder -P radius=3 -P height=10 --position 10,7.5,0
# Operationscli-anything-freecad --json -p p.json part boolean cut 0 1cli-anything-freecad --json -p p.json part copy 0cli-anything-freecad --json -p p.json part mirror 0 --plane XYcli-anything-freecad --json -p p.json part scale 0 --factor 2.0cli-anything-freecad --json -p p.json part loft --indices 0,1,2cli-anything-freecad --json -p p.json part sweep 0 1cli-anything-freecad --json -p p.json part revolve 0 --axis Z --angle 360cli-anything-freecad --json -p p.json part extrude 0 --direction 0,0,1 --length 10cli-anything-freecad --json -p p.json part fillet-3d 0 --radius 2cli-anything-freecad --json -p p.json part thickness 0 --thickness 1cli-anything-freecad --json -p p.json part compound --indices 0,1,2cli-anything-freecad --json -p p.json part section 0 --plane XYcli-anything-freecad --json -p p.json part info 0cli-anything-freecad --json -p p.json part line-3d --start 0,0,0 --end 10,5,0cli-anything-freecad --json -p p.json part wire --points "0,0,0;10,0,0;10,10,0"

sketch (26) — 2D constrained sketching

bash
cli-anything-freecad --json -p p.json sketch new --plane XYcli-anything-freecad --json -p p.json sketch add-line 0 --start 0,0 --end 20,0cli-anything-freecad --json -p p.json sketch add-circle 0 --center 10,10 --radius 5cli-anything-freecad --json -p p.json sketch add-rect 0 --corner 0,0 --width 20 --height 15cli-anything-freecad --json -p p.json sketch add-arc 0 --center 0,0 --radius 5cli-anything-freecad --json -p p.json sketch add-ellipse 0 --center 0,0 --major-radius 10 --minor-radius 5cli-anything-freecad --json -p p.json sketch add-polygon 0 --center 0,0 --sides 6 --radius 10cli-anything-freecad --json -p p.json sketch add-bspline 0 --points "0,0;5,10;10,0;15,10"cli-anything-freecad --json -p p.json sketch add-slot 0 --center1 0,0 --center2 10,0 --radius 2cli-anything-freecad --json -p p.json sketch constrain 0 distance --elements 0,1 --value 10cli-anything-freecad --json -p p.json sketch edit-element 0 0 --radius 8cli-anything-freecad --json -p p.json sketch remove-element 0 2cli-anything-freecad --json -p p.json sketch validate 0cli-anything-freecad --json -p p.json sketch solve-status 0# Constraints: coincident, horizontal, vertical, parallel, perpendicular, equal,#   fixed, distance, angle, radius, tangent, symmetric, block, diameter,#   point_on_object, distance_x, distance_y

body (38) — PartDesign features

bash
cli-anything-freecad --json -p p.json body newcli-anything-freecad --json -p p.json body pad 0 0 --length 10cli-anything-freecad --json -p p.json body pocket 0 1 --length 5cli-anything-freecad --json -p p.json body groove 0 0 --angle 360cli-anything-freecad --json -p p.json body fillet 0 --radius 2cli-anything-freecad --json -p p.json body chamfer 0 --size 1.5cli-anything-freecad --json -p p.json body revolution 0 0 --angle 360cli-anything-freecad --json -p p.json body additive-loft 0 --sketch-indices 0,1cli-anything-freecad --json -p p.json body additive-pipe 0 0 1cli-anything-freecad --json -p p.json body additive-helix 0 0 --pitch 5 --height 20cli-anything-freecad --json -p p.json body additive-box 0 -P length=10 -P width=10 -P height=10cli-anything-freecad --json -p p.json body hole 0 0 --diameter 5 --depth 10 --threadedcli-anything-freecad --json -p p.json body draft-feature 0 --angle 5cli-anything-freecad --json -p p.json body thickness-feature 0 --thickness 1cli-anything-freecad --json -p p.json body linear-pattern 0 --occurrences 5 --length 50cli-anything-freecad --json -p p.json body polar-pattern 0 --occurrences 6 --angle 360cli-anything-freecad --json -p p.json body mirrored 0 --plane XYcli-anything-freecad --json -p p.json body datum-plane 0 --reference XY --offset 10

material (8) — PBR materials with engineering properties

bash
# 21 presets: steel, aluminum, copper, brass, titanium, stainless_steel, cast_iron,#   carbon_fiber, nylon, abs, pla, petg, plastic_white, plastic_black, wood, glass,#   rubber, gold, concrete, granite, marblecli-anything-freecad --json -p p.json material create --preset steelcli-anything-freecad --json -p p.json material create --preset titaniumcli-anything-freecad --json -p p.json material assign 0 0cli-anything-freecad --json -p p.json material set 0 density 7800cli-anything-freecad --json -p p.json material import-material mat.jsoncli-anything-freecad --json -p p.json material export-material 0 --output mat.json

assembly (11) — Assembly management

bash
cli-anything-freecad --json -p p.json assembly new --name "MyAssembly"cli-anything-freecad --json -p p.json assembly add-part 0 0cli-anything-freecad --json -p p.json assembly constrain 0 coincident --components 0,1cli-anything-freecad --json -p p.json assembly constrain 0 distance --components 0,1 --distance 10cli-anything-freecad --json -p p.json assembly solve 0cli-anything-freecad --json -p p.json assembly dof 0cli-anything-freecad --json -p p.json assembly bom 0cli-anything-freecad --json -p p.json assembly explode 0 --factor 2.0# Constraints: fixed, coincident, distance, angle, parallel, perpendicular,#   tangent, revolute, prismatic, cylindrical, ball, planar, gear, belt

mesh (16) — Mesh operations

bash
cli-anything-freecad --json -p p.json mesh from-shape 0 --deviation 0.1cli-anything-freecad --json -p p.json mesh import path/to/model.stlcli-anything-freecad --json -p p.json mesh export 0 output.stl --format stlcli-anything-freecad --json -p p.json mesh boolean union 0 1cli-anything-freecad --json -p p.json mesh decimate 0 --target-faces 1000cli-anything-freecad --json -p p.json mesh smooth 0 --iterations 5cli-anything-freecad --json -p p.json mesh repair 0cli-anything-freecad --json -p p.json mesh to-shape 0

techdraw (15) — Technical drawings

bash
cli-anything-freecad --json -p p.json techdraw new-pagecli-anything-freecad --json -p p.json techdraw add-view 0 0 --direction 0,0,1 --scale 1.0cli-anything-freecad --json -p p.json techdraw add-projection-group 0 0cli-anything-freecad --json -p p.json techdraw add-section-view 0 0cli-anything-freecad --json -p p.json techdraw add-dimension 0 0 length --references 0,1cli-anything-freecad --json -p p.json techdraw add-annotation 0 "Note text"cli-anything-freecad --json -p p.json techdraw export-pdf 0 drawing.pdfcli-anything-freecad --json -p p.json techdraw export-svg 0 drawing.svg

draft (33) — 2D drafting

bash
cli-anything-freecad --json -p p.json draft wire --points "0,0,0;10,0,0;10,10,0"cli-anything-freecad --json -p p.json draft rectangle --width 20 --height 15cli-anything-freecad --json -p p.json draft circle --radius 10cli-anything-freecad --json -p p.json draft polygon --sides 6 --radius 10cli-anything-freecad --json -p p.json draft text --content "Hello" --position 0,0,0cli-anything-freecad --json -p p.json draft move 0 --vector 10,5,0cli-anything-freecad --json -p p.json draft array-linear 0 --direction 1,0,0 --count 5 --spacing 10cli-anything-freecad --json -p p.json draft array-polar 0 --center 0,0,0 --count 6cli-anything-freecad --json -p p.json draft extrude 0 --direction 0,0,1 --length 10cli-anything-freecad --json -p p.json draft to-sketch 0

measure (12) — Measurement and analysis

bash
cli-anything-freecad --json -p p.json measure volume 0cli-anything-freecad --json -p p.json measure area 0cli-anything-freecad --json -p p.json measure distance 0 1cli-anything-freecad --json -p p.json measure bounding-box 0cli-anything-freecad --json -p p.json measure center-of-mass 0cli-anything-freecad --json -p p.json measure check-geometry 0

surface (6) — Surface operations

bash
cli-anything-freecad --json -p p.json surface filling --edges 0,1,2cli-anything-freecad --json -p p.json surface sections --sections 0,1,2cli-anything-freecad --json -p p.json surface extend 0 --length 10cli-anything-freecad --json -p p.json surface sew --indices 0,1

fem (12) — Finite Element Analysis

bash
cli-anything-freecad --json -p p.json fem new-analysiscli-anything-freecad --json -p p.json fem add-fixed 0 --references face1,face2cli-anything-freecad --json -p p.json fem add-force 0 --references face3 --magnitude 1000cli-anything-freecad --json -p p.json fem set-material 0 0cli-anything-freecad --json -p p.json fem mesh-generate 0 --max-size 5cli-anything-freecad --json -p p.json fem solve 0cli-anything-freecad --json -p p.json fem results 0

cam (10) — CNC machining

bash
cli-anything-freecad --json -p p.json cam new-job 0cli-anything-freecad --json -p p.json cam set-stock 0 --stock-type boxcli-anything-freecad --json -p p.json cam set-tool 0 --diameter 6 --type endmillcli-anything-freecad --json -p p.json cam add-profile 0cli-anything-freecad --json -p p.json cam add-pocket 0 --depth 5cli-anything-freecad --json -p p.json cam generate-gcode 0cli-anything-freecad --json -p p.json cam export-gcode 0 output.nc

spreadsheet (7) — Parametric data tables

bash
cli-anything-freecad --json -p p.json spreadsheet newcli-anything-freecad --json -p p.json spreadsheet set-cell 0 A1 "50"cli-anything-freecad --json -p p.json spreadsheet set-cell 0 B1 "=A1*2"cli-anything-freecad --json -p p.json spreadsheet set-alias 0 A1 plate_widthcli-anything-freecad --json -p p.json spreadsheet export-csv 0 data.csv

import (13) — Import CAD/mesh files

bash
cli-anything-freecad --json -p p.json import auto model.stepcli-anything-freecad --json -p p.json import step model.stepcli-anything-freecad --json -p p.json import stl model.stlcli-anything-freecad --json -p p.json import dxf drawing.dxfcli-anything-freecad --json -p p.json import info model.step# Formats: step, iges, stl, obj, dxf, svg, brep, 3mf, ply, off, gltf

export (3) — Export to 17 formats

bash
# Presets: step, iges, stl, stl_fine, obj, brep, fcstd, dxf, svg, gltf, 3mf, ply, off, amf, pdf, png, jpgcli-anything-freecad --json -p p.json export render output.step --preset stepcli-anything-freecad --json -p p.json export render model.stl --preset stl --overwritecli-anything-freecad --json -p p.json export presets

session (4) — Undo/redo

bash
cli-anything-freecad --json -p p.json session undocli-anything-freecad --json -p p.json session redocli-anything-freecad --json -p p.json session statuscli-anything-freecad --json -p p.json session history

JSON Output

All commands support --json. Responses include structured data. Errors: {"error": "message"}.

Error Handling

  • Missing FreeCAD: Clear install instructions
  • Invalid types: Lists valid options
  • Index out of range: Reports valid range
  • File exists: Use --overwrite

Agent Preview Notes

  • Use preview capture --json whenever geometric changes need visual verification.
  • Use preview live start for iterative build loops; prefer poll mode when the project file is being saved repeatedly.
  • Use preview live status --json as the cheap status probe before reading the full trajectory.json.
  • Treat _bundle_dir as a single snapshot only; the stable live identity is _session_dir plus _trajectory_path.
  • Use cli-hub previews ... only to inspect/open already-published previews.

Source and attribution

Source:hkuds/cli-anythinginskills/cli-anything-freecadat commit34f5195

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from hkuds/cli-anything

Cli Anything Zoom

hkuds

Command-line harness for managing Zoom meetings, participants, and cloud recordings through the Zoom REST API.

Productivity & Workflow51Kupdated 2 weeks ago

Cli Anything Novita

hkuds

Documents a command-line client for the Novita AI API, offering chat, streaming, model listing, session and config commands.

Software Development51Kupdated 2 weeks ago

Cli Anything Zotero

hkuds

Agent-native CLI harness for inspecting and operating a local Zotero desktop library.

Research & Analysis51Kupdated 2 weeks ago

Cli Anything Wiremock

hkuds

CLI harness for administering a WireMock HTTP mock server via its Admin REST API.

Software Development51Kupdated 2 weeks ago

Cli Anything Slay The Spire Ii

hkuds

Controls the Slay the Spire 2 game through a local bridge mod HTTP API, reading state and sending actions.

Other51Kupdated 2 weeks ago

Cli Anything Shotcut

hkuds

Command-line interface for creating and editing Shotcut video projects and rendering them without a GUI.

Design & Creative51Kupdated 2 weeks ago

More in Design & Creative

Theme Factory

anthropics

Featured

Offers 10 preset color-and-font themes, plus custom theme generation, for styling slide decks, documents, reports and HTML pages.

Design & Creative179Kupdated today

Slack Gif Creator

anthropics

Featured

Creates animated GIFs sized and optimized for Slack, with PIL drawing helpers, easing and validation utilities.

Includes scripts
Design & Creative179Kupdated today

Frontend Design

anthropics

Featured

Guidance for distinctive, intentional visual design when building or reshaping a user interface.

Design & Creative179Kupdated today

Canvas Design

anthropics

Featured

Creates original visual art as PNG or PDF from a written design philosophy, for posters, artworks and other static pieces.

Design & Creative179Kupdated today

Brand Guidelines

anthropics

Featured

Applies Anthropic's official brand colors and typography to artifacts that should carry the Anthropic look-and-feel.

Design & Creative179Kupdated today

Frontend Design

anthropics

Featured

Guides an agent through distinctive, intentional visual design for new or redesigned user interfaces.

Design & Creative149Kupdated today