Repository navigation
Ketchup 0.3.0
Ketchup 0.3.0 puts DXF and DWG drawings under the model and lets you work on them, turns rule programs into drawing sets, cutting plans and quotes, gives Ketchup Viewer a language switch and a default projection, and makes connecting an AI harness a one-click step. It has about 530 changes since 0.2.0.
Work in progress. Ketchup is still far from a finished product. Expect missing features, rough edges, and bugs. Don't keep important models only in Ketchup yet.
What's new since 0.2.0
Drawings under the model (underlays)
- Keep a DXF or DWG drawing under the model, snap to it, and fit it by two points. It draws hatches, texts, points, true ellipses, and splines, reads old DOS code pages, and places drawings in national grid coordinates near the model.
- Work on the drawing itself: pick its lines, texts, and hatches; move, turn, and copy them; Trim, Extend, and Offset its lines; write text into it; and export it back to DXF or DWG.
- Tools → Pull drawing area up turns a click inside a closed area of the drawing into a solid. A drawing can stand in space as a plan or as a front, back, left, or right view.
- A program can build from a drawing too:
from_underlaymakes a solid from a closed region or a room named in the drawing. - The Layers panel counts what each underlay layer holds, and a drawing that is damaged in places is read with the bad elements skipped and named.
Programs and production
window()anddoor()cut their opening and keep a door's swing clear. Each counts as one bought item in the hardware list.- The Program parameters section edits a program's
param()values. Edits made in the window, such as Push/Pull, Move, renames, and colours, are written back into the program's own lines. - Drawing sets come out as numbered DXF or DWG sheets with a sheet list. They include a shop drawing of each build-up the program names, and mark the windows and doors on every plan. Exporting a set again replaces its old sheets.
- Cutting plans from declared stock (
bar_stock(),sheet_stock()): sheet layers are laid from whole boards that keep the factory edges. - A quote from the program's own prices (
price()), a fastener catalogue with ratings you can override (connector()), and a CNC DXF of each flat part. - Structural checks cover more cases honestly: notches over bearings, members on one support, wall frames without header depth, and side-only contacts.
Exports and speed
- COLLADA (DAE) export for SketchUp. STL, 3MF, GLB, and DAE exports run in the background.
- After an edit, the exact check measures only the parts that changed and their neighbours, spread over idle workers. Rotate beside a large model confirms about 100 ms faster.
- A document is saved in the oldest format that holds it.
Correction (November 2026): do not open files saved by 0.3.0 in 0.2.0 or 0.1.0. A file with a DXF profile imported in decimetres, kilometres, yards or miles is saved in a form 0.2.0 takes for damaged: it then opens the older .recovery copy beside the file without saying so, and saving there overwrites the newer file. Ketchup 0.3.1 saves such a file so that 0.2.0 refuses it and changes nothing.
Ketchup Viewer
- A Settings menu picks the interface language (English or Slovenčina) and the projection a fitted view opens in (perspective or parallel). Both are remembered between starts, in the Windows, macOS, Android, and web Viewer. The author of a package can also set a projection; your own choice wins.
- A package shows the dimensions the program placed, and a scene saved as a plan or elevation opens orthographic. Measured millimetres use your language's decimal mark.
- The Viewer has its own download,
Ketchup-Viewer-0.3.0-Portable.zip: one signedKetchupViewer.exeyou can send to a client together with a.ketchup-viewpackage, with nothing to install.
Correction (November 2026): the KetchupViewer.exe in Ketchup-Viewer-0.3.0-Portable.zip needs the Microsoft Visual C++ Redistributable (vcruntime140.dll), although its README says nothing has to be installed. On a Windows without it, install the redistributable or use the Viewer from 0.3.1, which needs nothing.
Connecting your AI harness
- The Connect AI section shows what Claude Code and Codex would start for Ketchup. If that is a program that no longer exists, it shows its path, and Set up or Use this Ketchup fixes it for every folder.
Ketchup.exe --mcp-setupdoes the same from a terminal, and the installer's last page offers it as a checkbox.- Over MCP, a client opens and imports local files without a consent prompt, and failures name their cause.
macOS
- Ketchup and Ketchup Viewer build and run on Apple Silicon Macs (
scripts/macos/build-app.sh). This release has Windows downloads only.
Correction (November 2026): an app built from the 0.3.0 tag lacks the program worker, so programs cannot be evaluated and DWG files cannot be imported in it. Build from 0.3.1 or later.
Files from 0.2.0 open in 0.3.0. A file with underlays or annotations needs 0.3.0. Files saved by 0.3.1 with a stretched (trimmed, extended or offset) drawing line need 0.3.1; 0.3.0 refuses them and changes nothing.
Install
- Download
Ketchup-0.3.0-Setup.exeand run it. It installs for the current user, without administrator rights, into%LOCALAPPDATA%\Programs\Ketchupand adds Ketchup and Ketchup Viewer to the Start menu. It replaces 0.2.0 in place. Leave Connect Claude Code and Codex to Ketchup (if installed) ticked on the last page to set up your AI harness. If you'd rather not install anything, useKetchup-0.3.0-Portable.zipinstead. - Download
Ketchup-0.3.0-Examples.zip, unpack it, and double-click any.ketchupfile.kitchen.ketchup-viewopens in Ketchup Viewer. - To only view packages, download
Ketchup-Viewer-0.3.0-Portable.zip, unpack it, and open a.ketchup-viewfile withKetchupViewer.exe.
Requires Windows 10 or 11 x64. The installer and the programs are signed by AEON GROUP spol. s r.o.
Connect your AI harness
Ketchup has no built-in chat. You connect the AI harness you already use, such as Claude Code, Codex, Claude Desktop, or Cursor, over MCP. Every AI edit goes through the same validation and Undo as a manual edit.
The installer sets up Claude Code and Codex for you. To do it later, run Ketchup.exe --mcp-setup or click Set up in Connect AI. By hand:
claude mcp add --scope user ketchup -- "$env:LOCALAPPDATA\Programs\Ketchup\Ketchup.exe" --mcp
codex mcp add ketchup -- "$env:LOCALAPPDATA\Programs\Ketchup\Ketchup.exe" --mcpSee the README.
Checksums (SHA-256)
See SHA256SUMS.txt.