# CLI Anything Freecad

Complete CLI harness for FreeCAD parametric 3D CAD modeler (258 commands).

- Repository: https://github.com/HKUDS/CLI-Anything (58029 stars)
- Category: Documents
- License: Apache-2.0
- Last updated: 2026-09-22
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add HKUDS/CLI-Anything --skill cli-anything-freecad -g -a claude-code -y`
Codex: `npx skills add HKUDS/CLI-Anything --skill cli-anything-freecad -g -a codex -y`
Cursor: `npx skills add HKUDS/CLI-Anything --skill cli-anything-freecad -g -a cursor -y`
Gemini CLI: `npx skills add HKUDS/CLI-Anything --skill cli-anything-freecad -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add HKUDS/CLI-Anything`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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 agents
cli-anything-freecad --json -p proj.json <cmd>  # With project file
cli-anything-freecad                            # Interactive REPL
```

## Preview, Live Preview, and Motion

FreeCAD is currently the deepest preview integration in this branch.

Preview commands:

```bash
# List preview recipes
cli-anything-freecad --json -p proj.json preview recipes

# Capture a real 4-view bundle
cli-anything-freecad --json -p proj.json preview capture --recipe quick

# Start poll-mode live preview
cli-anything-freecad --json -p proj.json preview live start --recipe quick --mode poll --source-poll-ms 500

# Query current live state without rendering
cli-anything-freecad --json -p proj.json preview live status --recipe quick

# Stop live preview publication
cli-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-session
cli-hub previews html /path/to/bundle-or-session -o page.html
cli-hub previews watch /path/to/session --open
cli-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:

The rest: https://github.com/HKUDS/CLI-Anything/blob/HEAD/freecad/agent-harness/cli_anything/freecad/skills/SKILL.md