text-to-cad README

The project's README from github.com/earthtojake/text-to-cad. As one markdown file: README.md.

Demo of the CAD skill generating and previewing CAD geometry
████████╗███████╗██╗  ██╗████████╗██████╗  ██████╗ █████╗ ██████╗ 
╚══██╔══╝██╔════╝╚██╗██╔╝╚══██╔══╝╚════██╗██╔════╝██╔══██╗██╔══██╗
   ██║   █████╗   ╚███╔╝    ██║    █████╔╝██║     ███████║██║  ██║
   ██║   ██╔══╝   ██╔██╗    ██║   ██╔═══╝ ██║     ██╔══██║██║  ██║
   ██║   ███████╗██╔╝ ██╗   ██║   ███████╗╚██████╗██║  ██║██████╔╝
   ╚═╝   ╚══════╝╚═╝  ╚═╝   ╚═╝   ╚══════╝ ╚═════╝╚═╝  ╚═╝╚═════╝ 

A library of agent skills for CAD, CAE and CAM

Docs

Tests Join Discord GitHub stars License: MIT Follow @earthtojake Python STEP STL 3MF URDF SDF SRDF

text-to-cad

text-to-cad is a library of agent skills for generating, inspecting, sourcing, slicing, and handing off CAD and robot-description artifacts from local project files.

CAD skill demo showing generated geometry in CAD Viewer CAD URDF skill demo showing robot description output in CAD Viewer URDF SRDF MoveIt2 skill demo showing inverse kinematics in CAD Viewer SRDF / MoveIt2

🧰 Skills

Install the library to give agents focused workflows for CAD, fabrication, robot description files, simulation, and local review.

Skill Summary Source
CAD Creates and edits CAD models from plain-language or image requests, with STEP as the main output along with options to export to STL, 3MF and GLB. skills/cad
CAD Viewer Shows local browser previews for CAD and robot files. skills/cad-viewer
step.parts Finds off-the-shelf STEP parts like screws, bearings, motors, and connectors. skills/step-parts
DXF Creates 2D DXF drawings like profiles, templates, gaskets, and cut layouts from Python sources or CAD geometry. skills/dxf
URDF Writes robot structure files with links, joints, limits, inertials, and meshes. skills/urdf
SRDF Adds MoveIt planning groups, end effectors, poses, and collision rules to a URDF. skills/srdf
SDF Creates simulator models and worlds with frames, physics, sensors, and lights. skills/sdf
SendCutSend Checks DXF and STEP files before upload to SendCutSend. skills/sendcutsend
DfAM Check Measures mesh printability per process: wall thickness, overhangs, support volume, and build orientation. skills/dfam-check
G-code Slices supported mesh files into validated, printer-profiled FDM .gcode with real slicer CLIs. skills/gcode
Bambu Labs Dry-runs, uploads, and cautiously starts local Bambu Lab print jobs from validated .gcode. skills/bambu-labs

💻 Installation

Install or clone from main: it is the source tree, and every skill's requirements.txt pins the cadgen release it was published with. (models/, the fixture corpus, arrives as small LFS pointers and is not needed to use the skills.)

Skills

Install text-to-cad with the Skills CLI:

npx skills add earthtojake/text-to-cad

This is the preferred installation path. It installs the individual skills directly for supported agents.

Use the same command to update. add re-fetches the package and overwrites what is already installed, so it both refreshes existing skills and installs any skill added in a newer release. npx skills update only refreshes skills already in your lockfile, so it silently misses new ones — which matters here, because releases do add skills.

Neither command removes a skill that was retired upstream; drop one with npx skills remove <skill> if you need to.

(npx skills install … still works — it is an undocumented alias for add.)

Plugins

Provider-native plugin installs are also available for Codex, Claude Code, and Grok Build:

# Codex (requires Codex 0.142.0 or newer)
codex plugin marketplace add earthtojake/text-to-cad
codex plugin add cad@text-to-cad

Codex resolves this repository-root plugin only from 0.142.0 onward. On older versions the plugin is skipped silently and never appears in codex plugin list; upgrade with npm install -g @openai/codex@latest.

# Claude Code
claude plugin marketplace add earthtojake/text-to-cad
claude plugin install cad@text-to-cad

Grok Build uses the existing .claude-plugin/marketplace.json; there is no separate Grok plugin manifest.

# Grok Build
grok plugin install earthtojake/text-to-cad --trust
grok plugin enable cad

Restart your agent if newly installed skills do not appear. For local development, branch from main, open PRs against main, and follow CONTRIBUTING.md.

🛠️ Contributing

Branch from main and open PRs against main. For local contribution workflow, skill linking, and validation guidance, see CONTRIBUTING.md.

text-to-cad (earthtojake/text-to-cad)

llm
Searching Database…

What is this?text-to-cad is a library of agent skills for CAD, CAE and CAM: it gives coding agents focused workflows to generate, inspect, source, slice, and hand off CAD and robot-description artifacts from your local project files.
So is this a CAD program I open, or something my coding agent uses?It is not an app you open — it installs a set of skills and provider-native plugins into coding agents you already use, and the agent then follows those workflows on your local files.
How do I install it into my agent?Install with the Skills CLI (npx skills add) — the preferred path; it installs the individual skills directly for supported agents, and the same command refreshes them later.
Which coding agents does it work with?Provider-native plugin installs are available for Codex, Claude Code and Grok Build, with Grok Build reusing the Claude plugin marketplace manifest. Codex must be 0.142.0 or newer — older versions skip the plugin silently.
Are there any gotchas when installing or updating it?Use npx skills add to install and update — npx skills update only refreshes lockfile skills and silently misses newly added ones. Retired skills are not removed automatically (drop them with npx skills remove), and restart your agent if newly installed skills do not appear.
What can the agent actually make with it?CAD models created and edited from plain-language or image requests, with STEP as the main output plus export to STL, 3MF and GLB; 2D DXF drawings such as profiles, templates, gaskets and cut layouts; and robot files — URDF structure with links, joints and limits, SRDF MoveIt planning groups, and SDF simulator models and worlds.
Can it take a part all the way to a 3D print?Yes. step.parts finds off-the-shelf STEP parts like screws, bearings, motors and connectors; DfAM Check measures mesh printability per process (wall thickness, overhangs, support volume, build orientation); the G-code skill slices meshes into validated, printer-profiled FDM .gcode; the Bambu Labs skill dry-runs, uploads and cautiously starts local print jobs; SendCutSend validates DXF and STEP files before upload.
Is there a big download or extra setup beyond the skills?No — the models/ directory, a fixture corpus, arrives as small LFS pointers and is not needed to use the skills. Each skill's requirements.txt pins the cadgen release it was published with.
Can I preview the models without a desktop CAD app?Yes — the CAD Viewer skill shows local browser previews for CAD and robot files straight from your machine.
Size
374 MB
Stars
21K
Age
5mo
Commits · 90 Days