678058c940
CI / Select checks (push) Has been cancelled
CI / Format and repository checks (push) Has been cancelled
CI / Compile RISC-V (manual) (push) Has been cancelled
Docker / image (push) Has been cancelled
Generated files / Regenerate and commit (push) Has been cancelled
Kernel rig / Select the rig areas (push) Has been cancelled
Lists / Design format changes merge cleanly (push) Has been cancelled
Lists / Lists are sorted one item per line (push) Has been cancelled
Packaging lint / lint (push) Has been cancelled
Pages / build (push) Has been cancelled
CI / Dependency advisories (push) Has been cancelled
CI / Quick compile (push) Has been cancelled
CI / Native Linux Clippy (push) Has been cancelled
CI / Build tests (push) Has been cancelled
CI / Native Linux tests (push) Has been cancelled
CI / GPU path tests (1/4) (push) Has been cancelled
CI / GPU path tests (2/4) (push) Has been cancelled
CI / GPU path tests (3/4) (push) Has been cancelled
CI / GPU path tests (4/4) (push) Has been cancelled
CI / Action matrix (1/16) (push) Has been cancelled
CI / Action matrix (10/16) (push) Has been cancelled
CI / Action matrix (11/16) (push) Has been cancelled
CI / Action matrix (12/16) (push) Has been cancelled
CI / Action matrix (13/16) (push) Has been cancelled
CI / Action matrix (14/16) (push) Has been cancelled
CI / Action matrix (15/16) (push) Has been cancelled
CI / Action matrix (16/16) (push) Has been cancelled
CI / Action matrix (2/16) (push) Has been cancelled
CI / Action matrix (3/16) (push) Has been cancelled
CI / Action matrix (4/16) (push) Has been cancelled
CI / Action matrix (5/16) (push) Has been cancelled
CI / Action matrix (6/16) (push) Has been cancelled
CI / Action matrix (7/16) (push) Has been cancelled
CI / Action matrix (8/16) (push) Has been cancelled
CI / Action matrix (9/16) (push) Has been cancelled
CI / Action matrix determinism (push) Has been cancelled
CI / Property tests (many cases) (push) Has been cancelled
CI / Doc tests (push) Has been cancelled
CI / Reference tests (push) Has been cancelled
CI / Windows D3D12 FXC shaders (push) Has been cancelled
CI / Windows app startup (push) Has been cancelled
CI / ci (push) Has been cancelled
CI / Compile WebAssembly (push) Has been cancelled
CI / Nightly alert (push) Has been cancelled
Kernel rig / Build the CLI (push) Has been cancelled
Kernel rig / Kernel rig (${{ matrix.shard }}) (push) Has been cancelled
Kernel rig / kernel-rig (push) Has been cancelled
Pages / deploy (push) Has been cancelled
3.3 KiB
3.3 KiB
name, description
| name | description |
|---|---|
| makecad-agent-tools | Use when running makeCAD to see a change working, driving it through the control channel or CLI, or adding or changing an MCP tool, control method or bundled agent skill. |
Running the app, the control channel and MCP tools
Run it and look at it
cargo run --release -p solidcraft -- --sample --control PORTstarts the sample design with the control channel. Pick a free port. With no display, run it underXvfb :99withDISPLAY=:99.- Talk JSON lines to
127.0.0.1:PORT(docs/control-protocol.md). The first request on a connection carries the launch token as"token": read it from~/.local/share/solidcraft/control/PORT.token, or start the app withSOLIDCRAFT_CONTROL_TOKEN=$(openssl rand -hex 32)and send that. Never paste the token into a PR or issue.{"id":1,"method":"engine.execute","params":{"command":"solid.extrude","params":{"distance":20}}}{"id":2,"method":"ui.start","params":{"command":"sketch.create"}}, thenui.click {x, y}{"id":3,"method":"ui.screenshot","params":{"path":"/tmp/shot.png"}}, then read the PNG
- For UI work, look at the result. Without a window use
ui.renderorsolidcraft-cli snapshot. - Headless:
solidcraft-cli run script.json --out part.step,solidcraft-cli eval design.sc,solidcraft-cli snapshot script.json --out shot.png,solidcraft-cli commands. - Build with
CARGO_TARGET_DIR=<repo>/target.
MCP tools
The server is solidcraft-cli mcp (crates/mcp/src/, docs/mcp.md). Tools are defined in crates/mcp/src/tools.rs; keep docs/mcp.md in step, and keep tool annotations (read-only, destructive) honest.
- Anything the user can do is a command; add a command, not a new tool, unless the tool is about the session itself (open, save, screenshot, batch).
- Files: tools reach only the allowed folders (the design's folder, the recovery folder, the scratch folder,
--allow-path). Do not widen this casually; paths are resolved before comparing, so..and links leaving the allowed set are refused, and on Windows UNC and device paths are refused. - Replies stay small:
verbose: false, no unfiltered command catalogue or topology dumps. - The control channel is a local-only interface with a token. A new method needs an entry in
docs/control-protocol.md; long work followsskills/makecad-performance/SKILL.md.
Bundled agent skills
All 17 skills and their text resources are embedded at build time by crates/mcp/build.rs for the read-only skill_reference tool. skills/agent-workflow.md is the shared generation workflow for MCP, the desktop assistant and the hosted Java gateway. Repository-only instructions do not grant the browser filesystem or shell capabilities.
- When a command, parameter name or behaviour those skills describe changes, update them in the same PR.
skills_name_only_real_tools_and_commandsincrates/mcp/src/tests.rsfails when a skill names a tool or command that is gone. - Adding a skill or text resource embeds it automatically. Run
node scripts/sync-cad-ai-skills.mjs <community-root>to update the Java package and rerun with--checkto detect drift; rebuild WASM and Java together. skills/README.mdexplains the layout and the other tests;cargo xtask skillschecks that AGENTS.md and every SKILL.md cite real paths, commands and skills.