# cuttobuild
**Repository Path**: cellinlab/cuttobuild
## Basic Information
- **Project Name**: cuttobuild
- **Description**: Agent-first design workbench for laser-cut and knife-cut assembly models, with 3D review, geometric checks and fabrication export.
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-16
- **Last Updated**: 2026-10-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# CutToBuild
**Design with your Agent. Inspect, refine, cut, and assemble.**
An open-source AI design workbench for laser-cut and knife-cut models. Your coding Agent creates the design; the browser shows the exact parts and lets you adjust them.
[简体中文](README.zh-CN.md) · [Design Skill](.agents/skills/design-flatpack-models/SKILL.md) · [Project format](docs/project-schema.md)
- **See the whole build:** orbit the 3D model, select parts, explode it, and play assembly one part at a time.
- **Refine the real geometry:** adjust dimensions, thickness and fit; pin notes to parts; edit custom outlines; move and rotate sheet placements. Solid intersections and continuous linear insertion collisions are reported.
- **Prepare fabrication:** export SVG/DXF, artwork, fit coupons, editable source and assembly instructions.
- **Show how it is made:** preview cutting paths and automatically record a captioned 720p assembly tutorial.
## Start
Node.js 22 or newer. No model account or API key required.
```sh
npm ci
npm run dev
```
Open the localhost URL printed by Vite. Open this repository in your coding Agent and ask it to use **`$design-flatpack-models`**. The Agent and browser share `.cuttobuild/session.json`.
Three editable studies are included: a plywood rover, a courtyard house, and a card racer. Original designs use custom planar contours, connections and assembly steps; they are not limited to these examples.
[Try the original 31-part tank →](examples/tank/README.md) Geometry checks, sheet layout, assembly and automatic tutorial recording.
```sh
npm run cli -- inspect
npm run cli -- feedback
npm run cli -- patch edit.json
npm run cli -- validate
npm run cli -- export --format bundle --out exports/my-model
```
The browser is a viewer and editor, with **no prompt/chat input**. Static builds support browser storage and JSON import/export; the local Agent bridge runs with `npm run dev`.
## Export
| Output | Purpose |
| --- | --- |
| SVG, DXF | Millimeter-scale cutting contours |
| PNG, JPG/JPEG, BMP, WebP | Print artwork and image previews |
| ZIP | Cutting files, artwork, source, notes, guide, report and fit coupon |
| WebM, or a supported browser video codec | Automatically recorded 1280×720 tutorial with captions and no audio |
Laser contours already include kerf compensation. Disable additional compensation in downstream software. Print registration and machine settings remain device-specific. Native **AI and LAC export are not implemented**; they need verified external adapters.
Digital geometry checks and insertion animations do not prove physical fit, assembly paths or structural strength. Test a coupon and verify the actual material before fabrication. Example rover wheels are fixed decorative parts, attached with glue.
## Develop
```sh
npm run check
npx playwright install chromium
npm run test:e2e
```
See [architecture](docs/architecture.md), [research](docs/research.md), [verification](docs/verification.md) and [contributing](CONTRIBUTING.md). `npm run build` creates a static `dist/` bundle. A hosted deployment is not included.
## 和 Maker 一起创造
[**加入造物矩阵 →**](https://zaowujuzhen.com/about) 展示作品、交换反馈，继续把想法做出来。
🎁 [**使用 `GITHUB` 领取月度会员**](https://zaowujuzhen.com/prime?plan=monthly&discount=GITHUB)：长期有效，每个账号限兑换一次。礼物由项目作者提供，与 GitHub 平台无关联。
## 关于 Cell 细胞
我是 **Cell 细胞**。我写代码，也写文章，把好奇心做成作品，探索更独立的工作与生活方式。
[个人站](https://cellinlab.com/) · [造物矩阵](https://zaowujuzhen.com/about) · [X / @cellinlab](https://x.com/cellinlab)
扫码加我的微信，备注 **GitHub**。
### 支持持续创作
如果这个项目对你有帮助，欢迎支持我继续做下去。
支付宝 |
微信 |
## License
[MIT](LICENSE). Original template copyright is retained. [Brand assets](public/brand/README.md) identify Maker Matrix and are separate from the code license.
