CADCraft Use
Plugin marketplaces
This plugin belongs to AIGC content creation.
| Category | Marketplace | Purpose |
|---|
| Full-stack development | Full Stack Plugins | Architecture and UI design, code understanding, quality checks, code review, workflow governance, and server operations |
| AIGC content creation | Full AIGC Plugins | Image, video, audio, music, 3D, and multimodal content creation |
CADCraft Use — precise 2D drafting
Draw, inspect, render, and save 2D CAD geometry through CADCraft's own command engine, with entity counts and a reopened DXF checked before delivery.
English | 简体中文 · Install · Quick start · Skills · MCP tools · Limits
Positioning
cadcraft lets an agent drive CADCraft's existing command registry instead of inventing a second CAD engine: start a drawing, run native commands, inspect entities, render the sheet, and save a DXF that reopens with the expected geometry. It packages twelve skills, a portable manifest, and one embedded editor server.
This is a development candidate. Production promotion is blocked, the current build is still pending public release, and GUI acceptance, desktop UI control, and external CAD compatibility remain separate open gates.
| Property | Value |
|---|
| Plugin ID | cadcraft |
| Display name | CADCraft Use |
| Version | 0.1.0-dev.20261018.4 |
| Stage | Installable development candidate, production promotion blocked |
| Native engine | CADCraft 0.3.0 command registry; editor build bundled, CLI external |
| Marketplace | cadcraft-marketplace |
| License | Apache-2.0 |
Installation
Prerequisites
- Codex is the host with recorded end-to-end evidence. Other hosts are not accepted.
- Node.js 24 or newer is required by the embedded editor. The distributed package contains the editor build; no Rust toolchain and no
npm install are needed at runtime.
- Headless file tasks and the
cadcraft-cli skill need an installed cadcraft-cli on the host. The plugin does not install it. Build or install it from the upstream CADCraft project, then check cadcraft-cli --version and cadcraft-cli commands in the host environment.
- The first Git-based launch needs network access or a verified editor cache.
CRAFT_EDITOR_UPDATE=off uses bundled assets.
CADCRAFT_CLI selects a binary only for scripts/launch.py; it does not change the editor entry in mcp.json.
From the plugin marketplace
codex plugin marketplace add partme-ai/full-aigc-plugins
codex plugin add cadcraft@full-aigc-plugins
This candidate is still marked as pending public release, with releaseStatus: BLOCKED. To test the exact build, use the repository-local marketplace cadcraft-marketplace, pinned to v0.1.0-dev.20261018.4. Restart the host, open a new task, and ask for one small drawing before a full sheet.
Quick start
- Open the editor with an absolute workspace: “Open CADCraft for this folder and list the available commands.”
- Query the live command registry before drawing. Do not treat a skill example as the complete schema; parameters and enabled state come from the installed version.
- Run one bounded command, for example a circle at
[10,10] with radius 4, then inspect the drawing and confirm the expected entity count.
- Save to a new absolute
.dxf path, reopen that exact file, and inspect again. Agree on any overwrite before saving over an existing file.
Draw: Create a 120 × 80 mm plate with four 6 mm holes on a 20 mm inset.
Inspect: List circles, lines, layers, and the handle of each new entity.
Bolt circle: Place six holes on a 60 mm pitch-circle diameter starting at 0°.
Export: Save the sheet to a new DXF, reopen it, and verify entity counts.
Direct runtime checks for the external CLI and the optional launcher:
cadcraft-cli --version
cadcraft-cli commands
python3 scripts/launch.py --doctor
What you can build
| Workflow | Built-in path | Verifiable output |
|---|
| Draw and inspect parts | cadcraft-use, cadcraft-mcp | Entity types, counts, handles, layers, and key coordinates |
| Parametric hole patterns | cadcraft-bolt-circle | Polar array from a real handle, hole count and pitch circle checked |
| Room plans | cadcraft-floor-plan | Room outline, openings, and wall geometry at stated dimensions |
| Dimensions and layers | cadcraft-dimension-part, cadcraft-layer-cleanup | Part dimensions, cleaned layers, linetypes, duplicates |
| Sheet output | cadcraft-sheet-export | Frame, paper, scale, and print output |
| Revision comparison | cadcraft-compare-revisions | Geometry and annotation differences between two drawings |
| Trace a reference | cadcraft-trace-reference | Two-axis calibration and a dimensioned vector outline |
| Scripted scenarios | cadcraft-scenario-playbooks | Eight recipes with real methods, parameters, and reopen checks |
| Visual editing | cadcraft-editor | Same-session UI plus a saved drawing file |
Skills
Entry and runtime
| Skill | What it does |
|---|
cadcraft-use | Choose the CLI or MCP path and define what a verified drawing means |
cadcraft-cli | Run headless file tasks with the installed cadcraft-cli |
cadcraft-mcp | Drive interactive, JSON, query, and render tools over MCP, including failure checks |
Drawing scenarios
| Skill | What it does |
|---|
cadcraft-bolt-circle | Build an equal-angle bolt pattern from a real handle and polar array |
cadcraft-floor-plan | Draw rooms, doors, and windows at given dimensions |
cadcraft-dimension-part | Dimension a mechanical part profile, holes, and sizes |
cadcraft-layer-cleanup | Clean layers, linetypes, and duplicate lines in a complex drawing |
cadcraft-sheet-export | Produce a sheet with frame, paper, scale, and print output |
cadcraft-compare-revisions | Compare geometry and annotations between two drawing versions |
cadcraft-trace-reference | Rebuild a dimensioned outline from confirmed reference control points |
Playbooks and editor
| Skill | What it does |
|---|
cadcraft-scenario-playbooks | Eight scenarios covering plates, flanges, door openings, grids, routing, hole rows, notches, and title frames |
cadcraft-editor | Open the real editor in an MCP Apps host or host browser and share one workspace session |
MCP tools
.codex-plugin/mcp.json starts one stdio server, cadcraft-editor, from ui/bootstrap.mjs. The adapter adds three stable tools and passes through the bundled engine's command catalog.
| Tool | Purpose |
|---|
open_editor | Default native design panel, registered as a conversation-side entrypoint; pass the absolute task workspace |
open_browser_editor | Explicit browser fallback for the same session; normal editor opening does not require this tool |
editor_status | Report whether the editor actually attached and is ready to accept commands |
The bundled catalog in ui/catalog.lock.json exposes command_line, script, execute, list_commands, inspect_drawing, query_entities, render, new_drawing, open, and save, plus UI tools when a desktop session is attached. render produces an image of drawing content, not a screenshot of an application window; screenshot, ui_inspect, and ui_click require a desktop control connection.
The default entry declares a thread entrypoint and a separate design surface. Tool metadata, resource metadata, and UI initialization all request fullscreen, which desktop hosts present as a separate conversation panel. open_editor does not return a browser URL. Wait for editor_status({wait_ms:10000}) to return state: "ready"; use the browser fallback only when explicitly needed. Host rendering acceptance is recorded separately from metadata tests.
Configuration
| Setting | Meaning |
|---|
${PLUGIN_ROOT} | Expanded by the portable plugin.json and mcp.json |
${CLAUDE_PLUGIN_ROOT} | Expanded by the Claude Code manifest and root .mcp.json |
CRAFT_EDITOR_UPDATE=off | Use the bundled editor only and skip the update query |
CRAFT_EDITOR_CACHE_DIR | Alternate absolute cache directory; default is ~/.cache/full-aigc/editors |
CRAFT_WORKSPACE_ROOT | Workspace root when the adapter is started directly |
CRAFT_PANEL_METADATA_FILE | Host panel metadata used by the ZCode and Claude Code entries |
CADCRAFT_CLI | Binary path for scripts/launch.py --doctor or its desktop mode only |
Architecture and security
flowchart LR
U[User] --> H[Agent host]
H --> S[12 skills]
S --> M[stdio MCP cadcraft-editor]
M --> E[Bundled CADCraft engine]
E --> D[DXF or export]
S --> C[External cadcraft-cli]
M -.->|loopback control| A[CADCraft desktop app]
| Mode | Available tools | State boundary |
|---|
| Bundled editor over stdio MCP | Drawing commands, inspection, render, open/save | One drawing session per MCP process |
| Desktop control connection | Headless tools plus screenshot, ui_inspect, ui_click | State lives in the running CADCraft app |
- The plugin owns manifests, skill guidance, a source-commit and SHA-256 skill lock, validation scripts, and the editor bridge. The CAD command engine belongs to CADCraft.
- MCP runs over stdio. The editor page uses a loopback HTTP server with a random token and Host/Origin checks; workspace escapes are rejected.
- There is no plugin-side operation journal, command deduplication, transaction, or automatic rollback. A transport response is not an exactly-once guarantee.
- After a timeout on create, delete, or save, treat the outcome as unknown and inspect the drawing or the last saved file before acting again.
- Manual browser exports land in
craft-exports/ with new file names; closing the process ends the session.
Troubleshooting
| Symptom | Cause | What to do |
|---|
cadcraft-cli not found | The plugin does not install the external CLI | Install or build it upstream, then put it on the host PATH for file tasks |
screenshot or ui_inspect missing | A headless session has no desktop UI tools | Start CADCraft with --control PORT and connect the launcher to loopback |
| A desktop write times out | The upstream remote backend may replay the request | Inspect the drawing or saved file first; never resend blindly |
| DWG export expected | Web does not support DWG | Deliver DXF, or convert in a desktop workflow that actually supports DWG |
| Dimension text looks wrong in the GUI | GUI dimension text has not passed acceptance | Check the rendered sheet and report the exact version; do not claim GUI text is verified |
| DXF opens here but not in another CAD app | External compatibility is unverified | Record the target application and its exact error; round-trip here is not external proof |
| The embedded panel never appears | The host does not render MCP Apps | Use the open_browser_editor URL; a text result is not a rendered panel |
| A hole pattern is treated as production-ready | The sample is a drawing exercise, not manufacturing design | Require an engineering review before fabrication |
Upgrade
codex plugin marketplace upgrade full-aigc-plugins
codex plugin add cadcraft@full-aigc-plugins
The editor update is independent of the plugin version. editor_status reports whether the runtime came from a download, the cache, or bundled assets.
Contributing and support
Open issues at https://github.com/full-aigc-plugins/cadcraft-plugin/issues. Include plugin, engine, and CLI versions, the mode (bundled editor, headless CLI, or desktop control), the command name and parameters, expected versus observed entity counts, and whether the saved file was reopened. Never attach private drawings without authorization.
License
Apache-2.0. The three pinned upstream skills come from full-aigc-skills/cadcraft-skills and are locked by commit and per-file SHA-256; the CADCraft engine and CLI remain external. See LICENSE and assets/official-icon-source.json.
