GitHub - earthtojake/text-to-cad: An open source harness for generating CAD models

✨ Features

Generate - Create source-controlled CAD models with coding agents like Codex and Claude Code.

- Create source-controlled CAD models with coding agents like Codex and Claude Code. Export - Produce STEP, STL, 3MF, DXF, GLB, topology data, and URDF robot descriptions.

- Produce STEP, STL, 3MF, DXF, GLB, topology data, and URDF robot descriptions. Browse - Inspect generated geometry in CAD Explorer.

- Inspect generated geometry in CAD Explorer. Reference - Copy stable @cad[...] references so agents can make precise follow-up edits.

- Copy stable references so agents can make precise follow-up edits. Review - Render quick snapshots for fast checks during an iteration loop.

- Render quick snapshots for fast checks during an iteration loop. Reproduce - Edit source files first, then regenerate explicit targets.

- Edit source files first, then regenerate explicit targets. Local - Run the harness and CAD Explorer locally with no backend to host.

???? Bundled Skills

This harness vendors file-targeted skills for CAD, robot-description, robot-motion, and manufacturing-preflight work. Use the bundled copies here for local CAD projects, or use the dedicated repositories when installing the skills outside this harness.

CAD Skill - STEP, STL, 3MF, DXF, GLB/topology, snapshots, and @cad[...] geometry references. Bundled docs · Standalone repo

- STEP, STL, 3MF, DXF, GLB/topology, snapshots, and geometry references. Bundled docs · Standalone repo URDF Skill - Generated URDF XML, robot links, joints, limits, validation, and mesh references. Bundled docs · Standalone repo

- Generated URDF XML, robot links, joints, limits, validation, and mesh references. Bundled docs · Standalone repo Robot Motion Skill - ROS 2/MoveIt setup, CAD Explorer motion artifacts, inverse kinematics, path planning, and motion-server testing for existing URDFs. Bundled docs

Skills live canonically under .agents/skills for Codex. Claude Code compatibility is provided by per-skill symlinks in .claude/skills .

???? Screenshots

???? Workflow

Describe - Tell your agent about the part, assembly, fixture, robot, or mechanism you want. Edit - Let your coding agent update repo-local CAD source files. Regenerate - Create explicit STEP, STL, 3MF, DXF, GLB, or URDF targets. Inspect - Open CAD Explorer to review the generated model. Reference - Copy @cad[...] handles when you want geometry-aware edits. Commit - Save the source and generated artifacts together once the model is ready.

???? Quick Start

Clone the repo:

git clone https://github.com/earthtojake/text-to-cad.git cd text-to-cad

Install Python CAD dependencies:

python3.11 -m venv .venv ./.venv/bin/python -m pip install --upgrade pip ./.venv/bin/pip install -r .agents/skills/cad/requirements.txt

Install other bundled skill requirements only when you need those workflows:

./.venv/bin/pip install -r .agents/skills/urdf/requirements.txt

Install CAD Explorer dependencies:

npm --prefix .agents/skills/cad/explorer install

Run the local CAD Explorer from the project directory you want to scan:

npm --prefix .agents/skills/cad/explorer run dev:ensure

Then open http://localhost:4178.