Annealage
Annealage Mesh PN-05 / CAD

Point at the part. The agent revises the geometry.

Mesh is an agentic CAD workbench for 3D-printable parts. A live 3D viewer and an agent chat pane sit side by side in the browser; the agent writes CadQuery geometry, and the regenerated STL appears within a fraction of a second. Click the face that's wrong, type what's wrong with it, and the agent gets the comment back with its model-space coordinates.

[ ok ] uvx annealage-mesh ./part · available now · free for non-commercial use

agent@mesh MCP · MESH
01 uvx annealage-mesh ./part # serve passed
02 mesh list_comments # 1 pin at xyz passed
03 uv run model.py # CadQuery → shroud.stl passed
04 mesh mesh_verify # watertight, 1 body passed
05 mesh add_callout # approved passed
06 agent: revise, re-run
loop pin → revise → regenerate → verify → callout
Annealage Mesh reviewing a side-scroll fan duct for a dual V100 radiator: the human's pin on a turning vane, the agent's numbered callouts measuring what restricts the airflow, the review panel, and the chat pane with its findings
FIG. 0: one human pin, six agent callouts, and the agent's findings in the chat pane
FIG. 1: the review loop

Pins both ways, on the same model.

Switch to Add pin, click the model, and type a comment against that point. Submitted pins carry the part, the click point and the surface normal in model units, so the agent maps each comment straight to the line of the CAD script that made it.

The agent pins back. Its callouts, a point and a note each, appear live in the viewer, so a question about a wall or a measurement of what clips the bore sits on the geometry it's about, not in a paragraph.

  • pins Human comments at exact model-space coordinates, with part and normal.
  • callouts The agent's own pins, drawn live in the viewer.
  • measure Pick any two pins for ΔX/ΔY/ΔZ and the direct distance.
  • sketch Draw on the 3D view and send it as an image; paste or drop photos too.

Bring the agent in the chat pane, or your own.

SHEET 02 / CHAT · CONTRACT

The agent works the viewer as well as the folder: it moves the camera, hides and shows parts, captures what's on screen, and pins callouts. Pause holds the view still while you line up a shot or type a comment.

MODE A built-in

Chat pane beside the viewer

Claude, Codex or omp as the backend, switchable per run, with image attachments, interrupt, a per-turn cost and context readout, and kept sessions you can resume. On a phone the panes become tabs.

claude · codex · omp
MODE B external

Two JSON files and MCP tools

An agent running outside the chat pane reads mesh-comments.json and writes mesh-callouts.json in the served folder, plus MCP tools for STL verification and the measured dimensions file.

file contract · MCP tools
Approvals and containment

A contained shell, and a card for everything else.

The agent's shell runs sandboxed, so regenerating a part inside the project folder doesn't ask. Anything that writes through the edit tools, leaves the folder, or reaches the network arrives as an approval card with the full command or file contents: allow it, allow it for the session, or deny it with a reason the agent reads verbatim.

A served folder's own .claude/settings.json or .mcp.json can declare hooks that run shell commands, so Mesh won't start the agent in that folder until you accept those files, recorded against the exact contents you read.

  • sandbox bubblewrap + socat on Linux, the built-in sandbox on macOS. Agent mode won't start uncontained.
  • secrets Credential paths such as ~/.ssh and ~/.aws are refused to the file tools and to shell commands that name them.
  • viewer Reading and moving the view never asks; callouts, screenshots and dimension writes do.
  • bind 127.0.0.1 by default, with a per-run token in the URL.
The CAD pipeline

A parametric CadQuery project, scaffolded for you.

Point Mesh at a folder and it sets up a dimensions.json for caliper measurements, a model.py with PEP-723 inline dependencies, and helper scripts that keep OCCT honest, then starts the server and opens the browser.

  • 01 evidence Measured values live in one file; derived numbers are computed in the script.
  • 02 scaffold uv run model.py models the reference hardware first, then the part against it.
  • 03 solids Fillets that fall back instead of failing, and checks for silent boolean failures.
  • 04 verify Section probes and a watertightness check before you see the part.
  • 05 print Orientation, splitting hollow parts, plate layout, volume-guarded watertight export.

Point it at a folder.

SHEET 03 / INSTALL
01 / run

Run it from PyPI

With uv there is nothing to install first. Python 3.10+; the viewer is served locally and needs no network.

uvx annealage-mesh ./part
# or keep it as a tool
uv tool install annealage-mesh
02 / sandbox

Linux: the sandbox tools

Agent mode needs these to contain the shell. macOS needs nothing; annealage-mesh view needs neither.

apt install bubblewrap socat
03 / backend

Pick a backend

Claude uses the Claude Agent SDK (about 90 MB, it bundles the CLI); Codex and omp install separately.

annealage-mesh ./part \
  --backend claude --save-default

Subcommands, sessions, remote access, and the file contract for external agents live in the Mesh docs.