agentcad 0.2.1

CLI CAD tool for AI agents. Write CadQuery scripts, get STEP files, renders, and metrics.

agentcad

CAD tool for AI agents. Give your coding agent the ability to design 3D models.

Your agent writes CadQuery or build123d Python scripts. agentcad handles execution, STEP export, PNG rendering, mesh export (STL/GLB/OBJ), geometric metrics, validation, diffing, and browser preview. All command output is structured JSON.

agentcad is open source under the Apache License 2.0. It runs locally and requires no signup.

Quick start

Install agentcad, then paste this into Claude Code, Cursor, or any coding agent:

Create a Python 3.12 virtual environment, then:

pip install agentcad
agentcad skill install
agentcad --help

Read the --help output — it's your operational briefing.

Then design me a phone stand: a simple angled cradle that holds a phone
at 60 degrees. About 80mm wide, 50mm deep, with a 5mm lip at the bottom
to keep the phone from sliding. Show me a preview when you're done.

What it does

• agentcad run script.py --output label — execute a CadQuery script, produce versioned STEP file + geometric metrics (volume, dimensions, validity, face/edge counts)
• agentcad run ... --preview — four-view PNG + turntable GIF for visual verification
• agentcad run ... --render iso,front — high-quality PNG views
• agentcad run ... --export stl,glb — mesh export for 3D printing or web viewers
• agentcad inspect output.step — topology deep-dive (shells, free edges, validity)
• agentcad diff 1 2 — compare versions (metrics, outputs, parameters)
• agentcad view output.step — open STEP/GLB output in a browser preview viewer
• agentcad docs [section] — 16 sections of built-in documentation

No boilerplate

Scripts need zero imports. cq, show_object, and 16 geometry helpers are pre-injected:

box = cq.Workplane('XY').box(10, 20, 5)
show_object(box)

Helpers include translate, rotate, mirror_fuse, loft_sections, tapered_sweep, involute_gear_profile, and more. Run agentcad docs helpers for the full list.

MCP integration

For native tool integration with Claude Code, Cursor, or Windsurf:

pip install agentcad[mcp]

Add to .mcp.json:

{"agentcad": {"command": "python", "args": ["-m", "agentcad.mcp"]}}

Requirements

• Python 3.10–3.12 (CadQuery/OpenCascade does not support 3.13+)

License

Apache License 2.0. See LICENSE.

Feedback

If your agent struggles, run agentcad feedback "what happened" to capture a friction log.