BOMWiki/partmode

git clone https://github.com/BOMWiki/partmode.git && cd partmode && npm ci && npm run build && npm start

Usage

• •Open http://127.0.0.1:4401 — browser-local CAD requires no account or external service (needs Node.js 22.13+).
• •Create a revocable key at partmode.com/account, then register the hosted MCP: codex mcp add partmode --url https://partmode.com/mcp --bearer-token-env-var PARTMODE_AGENT_KEY.
• •Call cad_capabilities before constructing a transaction; use a browser-approved session for visible approval or a headless-granted edit key for unattended server projects.
• •Run the contributor gate with npm run ci:gate.

Key features

• ✓Constrained sketches, editable feature history, exact B-rep via OpenCascade, assemblies, drawings, and STEP/DXF/STL/AMF/3MF exchange.
• ✓One shared document model and exact kernel for both human and agent edits.
• ✓Hosted MCP tools for capabilities, inspection, queries, detached previews, revision-safe commits, browser artifacts, and opt-in server-headless STEP.
• ✓Anonymous browser CAD with project/recovery history kept in browser storage; headless documents are account-owned and durable.

Best for

People plus permissioned AI agents collaboratively building parametric CAD with exact geometry, exported to STEP.

Caveats

• ⚠GNU AGPL v3; hosted browser-agent access requires an account, revocable agent key, signed-in PartMode tab, and visible approval.
• ⚠The relay is not end-to-end encrypted and has no offline queue; live headless sessions expire within one hour and do not survive restarts.
• ⚠No engineering simulation, CAM, native DWG authoring, or general standards-certified GD&T/PMI workbench; imported STEP doesn't reconstruct native history/mates/PMI.
• ⚠No individual project-delete control yet for committed headless documents.