Local agent-driven OS for 3D-printable meshes (repair + mechanical design + organic authoring).
| Doc | Role |
|---|---|
| docs/archive/Difficulty.md | Binding law (Rogue2 lessons) |
| docs/MeshOps.md | Product spec |
| docs/TechStack.md | Dependency pins |
| docs/PRD.md | Short PRD |
| conductor/conductor.md | Tracks |
| conductor/deferred.md | Parking lot (not a work queue) |
| conductor/planner-handoff.md | Living cold-start for planners |
Local only (gitignored): conductor/, docs/, .agents/ (skills including onboarding), AGENTS.md (agent rules — Ledgerful-style compact policy). |
Status: Design + local conductor/skills + quality gates. Product code tracks start at 0001.
# 1. Python env (requires Python >=3.13,<3.14)
uv sync --extra dev
# optional T7 design stack:
# uv sync --extra design
# optional MCP stdio adapter (Claude Desktop / Cursor / Inspector):
# uv sync --extra mcp
# uv run meshops-mcp # or: python -m meshops.mcp (set cwd=repo; MESHOPS_WORK optional)
# docs: docs/mcp/README.md
# optional multi-view proportion overlays + JPG/WebP (track 0012):
# uv sync --extra proportion
# uv run meshops proportion template|analyze|show
# 2. Diagnose tools (default: core env only — missing Blender/Orca is a warning)
uv run meshops doctor
uv run meshops doctor --json
# print/organic-ready box:
# uv run meshops doctor --strict
# 3. Bootstrap portable Blender 5.2 LTS if missing (Difficulty §4 mirrors)
# Requires a **repo clone** — scripts/ is not shipped in the pip/uv wheel.
.\scripts\bootstrap-tools.ps1
# dry-run (no network):
.\scripts\bootstrap-tools.ps1 -WhatIf
# 4. OrcaSlicer 2.4.2 (manual): GitHub Releases or Microsoft Store, then:
# $env:MESHOPS_ORCA = 'C:\Program Files\OrcaSlicer\orca-slicer.exe'meshops doctor composes existing Blender/Orca discoverers; bootstrap sets MESHOPS_BLENDER (User + current session) and installs under %LOCALAPPDATA%\MeshOps\tools\blender-5.2.0\.
uv sync --extra dev
uv run ruff check .
uv run ruff format --check .
uv run basedpyright
uv run pytest
# or all four via:
ledgerful verifyCI: .github/workflows/ci.yml (Python 3.13, Node 24, uv 0.12.0). Pins: docs/TechStack.md §7.
Blender manual epub under docs/blender_manual_v520_en.epub is reference only.