earthtojake/text-to-cad

Give your agent CAD superpowers.

這是什麼

text-to-cad 是一組把 AI 代理接上本機 CAD 工作流的工具與技能集，主軸不是單純「用文字生成模型」，而是讓 Claude Code、Codex、Cursor、Gemini、Grok 等支援外掛或 skills 的代理，能在本機產生與處理 STEP、GLB、STL、3MF 等 3D 檔案。README 強調它還涵蓋製造前檢查、工程圖，以及與 3D 列印、鈑金、CNC 製造服務的連接；底層則透過 cadgen、build123d 與 Open CASCADE 這類 CAD/幾何工具鏈運作。換句話說，它想補上的不是聊天介面，而是讓代理能把「設計意圖」落到可檢視、可匯出、可送製造的模型檔。

為什麼上榜

這個專案今日新增 619 stars、累積約 17,961 stars，熱度來自一個很明確的趨勢：AI 代理正在從寫程式走向操作專業工具。text-to-cad 的亮點是它沒有只押一個單一 App，而是把安裝路徑拆給 Claude Code、Claude Desktop、Codex、Cursor、Grok Build、Gemini，以及沒有外掛支援的其他代理。README 也花大量篇幅處理更新、重裝、viewer、MCP server 與 uv runtime，顯示它的定位更像「代理時代的 CAD 基礎設施」，而不是展示型 demo。值得注意的是，CAD 牽涉本機原生依賴與安全限制，README 特別列出 Windows 11 Smart App Control 可能阻擋 OCP unsigned native module，這也說明此類工具的門檻仍比一般 Web/LLM 套件高。

適合誰，可以拿來做什麼

它最適合已經在使用 AI coding agent、但希望把代理能力延伸到 機械設計、機器人、3D 列印或製造前檢查 的使用者。典型情境包括：請代理依自然語言或圖片建立 CAD 模型、輸出 STEP/STL/3MF/GLB、產生工程圖 PDF、建立 DXF 切割圖、撰寫 URDF/SRDF/SDF 機器人描述檔，或對 SendCutSend、3D 列印、鈑金、CNC、射出成型相關檔案做 DFM/DfAM 檢查。上手門檻主要在代理外掛生態與本機 CAD runtime：README 建議用 uv 來跑 CAD，第一次啟動會下載 runtime；若只是想讓沒有外掛的代理取得技能，也可透過 Skills CLI 安裝。

上手

README 建議最簡單的方式是直接請代理安裝：

Install text-to-cad from https://github.com/earthtojake/text-to-cad

若要手動安裝，先確認有 uv，再依使用的代理選擇對應指令。例如 Claude Code：

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

沒有專屬外掛的代理可安裝 skills：

npx skills add earthtojake/text-to-cad#latest

README 也提醒：同一個 app 內不要同時安裝 plugin 與 skills，否則每個 skill 會出現兩份；更新後通常需要重啟代理應用。

README 重點摘要

• 支援 STEP、GLB、STL、3MF 輸出，並包含 CAD viewer 與本機 cadgen mcp server 的工作流。
• 提供 CAD、step.parts、Engineering Drawing、DXF、URDF、SRDF、SDF、SendCutSend、DfAM Check、DFM、G-code 等多個專門技能，涵蓋設計、檢查、機器人描述與製造準備。
• 安裝方式依代理而異，README 分別列出 Claude Code、Claude Desktop、Codex、Cursor、Grok Build、Gemini 與 Other Agents 的流程。
• 使用者可選擇是否分享匿名使用統計；README 說明可用介面、uvx cadgen analytics on|off 或 DO_NOT_TRACK=1 控制。
• Windows 11 若啟用 Smart App Control，可能因 OCP unsigned native module 導致 cadgen 或 build123d 匯入失敗，README 建議關閉該功能或改在 WSL 執行。