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)

Searching Database…

这是什么?text-to-cad 是一套面向 CAD、CAE 和 CAM 的 agent 技能库:它为编码 agent 提供专注的工作流程,可以从你本地的项目文件中生成、检查、寻找来源、切片并交付 CAD 和机器人描述类的产物。
所以它是一个我打开来用的 CAD 软件,还是给我的编码 agent 用的?它不是你打开来用的应用——它把一组技能和各提供商原生的插件装进你已经在用的编码 agent 里,然后 agent 会按照这些工作流程处理你本地的文件。
怎么把它装到我的 agent 里?用 Skills CLI 安装(npx skills add)——这是推荐的方式;它会为受支持的 agent 直接安装各个技能,以后用同一条命令即可刷新更新。
它支持哪些编码 agent?Codex、Claude Code 和 Grok Build 都有提供商原生的插件安装方式,其中 Grok Build 复用了 Claude 插件市场的清单文件。Codex 需要 0.142.0 或更新版本——旧版本会静默跳过插件。
安装或更新的时候有什么坑吗?安装和更新都用 npx skills add——npx skills update 只会刷新锁文件里的技能,会静默漏掉新添加的技能。已下架的技能不会自动删除(用 npx skills remove 移除),另外如果新装的技能没有出现,请重启你的 agent。
agent 用它到底能做出什么?可以根据自然语言或图片请求创建和编辑 CAD 模型,主要输出 STEP 格式,还能导出为 STL、3MF 和 GLB;可以生成 2D 的 DXF 图纸,比如轮廓、模板、垫片和排料切割图;还能生成机器人文件——包含连杆、关节和限位的 URDF 结构、SRDF 的 MoveIt 规划组,以及 SDF 仿真模型和仿真环境。
它能帮我把一个零件一路做到 3D 打印吗?可以。step.parts 能找到现成的 STEP 零件,比如螺丝、轴承、电机和连接器;DfAM Check 会按工艺衡量网格的可打印性(壁厚、悬垂、支撑体积、打印摆放方向);G-code 技能把网格切片成经过验证、按打印机配置档案生成的 FDM .gcode;Bambu Labs 技能可以试运行、上传并谨慎地启动本地打印任务;SendCutSend 会在上传前校验 DXF 和 STEP 文件。
除了这些技能,还要下载很大的东西或做额外配置吗?不用——models/ 目录是一套测试用模型库,只会以很小的 LFS 指针形式下载,使用这些技能并不需要它。每个技能的 requirements.txt 都固定了它发布时所用的 cadgen 版本。
不用桌面 CAD 软件也能预览模型吗?可以——CAD Viewer 技能直接在你的电脑上为 CAD 和机器人文件提供本地浏览器预览。
Size
377.2 MB
Stars
21.4K
Age
5mo
Commits · 90 Days