earthtojake / text-to-cad

Give your agent CAD superpowers.
Docs
# text-to-cad
The text-to-cad plugin gives your agent local workflows for generating 3D models
as STEP, GLB, STL or 3MF files. It also does design for manufacturing checks,
generates engineering drawings, and connects to popular 3D printing, sheet metal
and CNC fabrication services.
It is supported by all popular agents that support plugins or the
skills framework, including Claude Code, Codex, Cursor,
Gemini and Grok.
## 💻 Install
### Ask your agent (recommended)
Send this message to your agent and it will install text-to-cad for you.
 [code] 
By default, text-to-cad sends usage stats and crash reports, tagged with a random
ID and never including your files, paths or prompts; turn them off with
`uvx cadgen telemetry off`, or ask your agent to. Telemetry says
the rest.
Or install it yourself:
1. CAD runs through uv: check that it is installed
 (`uv --version`), and if it is missing, install it with
 uv's installer.
2. Run the commands under your agent app's heading below, or under
 Other Agents if it has none.
3. Restart the app. Its first start downloads CAD's runtime, so it needs a network
 connection.
The plugin for your agent app brings the skills and CAD's viewer, a local server
(`cadgen mcp`). For an agent without a plugin, install the skills alone. Install
one or the other in an app, not both: two copies means every skill twice.
The install commands below take the `latest` branch: it holds the plugin alone
and gets each release once it is on PyPI. `main`, where development happens,
installs too, but can hold changes that aren't released yet. Each app names the
branch in its own way (`#latest`, `--ref latest`, `@latest` or
`--branch latest`); leave it out and the app installs `main`.
Each app's heading also says how to update text-to-cad, and how to reinstall it:
remove it, then install it again. Updating the plugin updates CAD: the new
release's cadgen is downloaded the first time it runs, and the skills and the
server share it. Earlier releases stay in uv's cache until you run `uv cache prune`.
### Claude Code
 [code] 
The plugin also starts CAD's server. Where Claude Code can show app views, CAD
shows models as viewer cards in the conversation; otherwise, as in a terminal,
asking it to show a model gives you a link that opens the model in the CAD
Viewer in your browser.
To update, run these, then restart Claude Code:
 [code] 
To reinstall, remove it with these, then run the install commands again:
 [code] 
### Claude Desktop
CAD shows models in the chat: ask Claude to show one and it appears as a viewer
card you can orbit, add to your prompt, and open full size; Claude can read what
you selected and see what you see. It runs locally through uv: add the server to
Claude Desktop's config (Settings > Developer > Edit Config), then restart the
app. If Claude Desktop cannot find `uvx`, give its full path (`which uvx`).
 [code] 
The config pins a cadgen release in `args`, and uvx keeps the version it first