Parametric joinery

Traditional joints that recut themselves when the timbers change

In Kumiki, a joint is a function of the timbers it connects—not a boolean box you draw by hand. Change a timber’s cross-section, move a post, or steepen a roof pitch, and every shoulder, housing, tenon, wedge and peg hole is recomputed from the geometry.

Posts, beams and braces

Mortise and tenon

The workhorse of a timber frame. A tenon on the end of one timber enters a mortise in the face of another, with optional housings, shoulders, draw-bored round or square pegs, wedges, or tusks. When a post or beam changes size, the tenon thickness, shoulder plane and peg holes recut to match.

Pegged mortise and tenon brace joint at an angle Wedged half-dovetail through mortise and tenon joint

Joists, girts and opposing beams

Drop-in and double butt joints

Floor joists and girts often drop into pockets from above so they can be set after the main bents are raised. Where two beams meet from opposite sides of a post, a shared spline or opposing tenon ties them through the post without blowing out the mortise.

Drop-in dovetail butt joint (ari-tsugi) X-ray view of a drop-in dovetail butt joint

Extending sills, plates and girts

Splice and scarf joints

When a mudsill or top plate runs longer than a single stick of lumber, a lengthening joint (tsugite) joins two collinear timbers end to end. From simple half-laps to interlocking gooseneck and rabbeted oblique scarfs, each cut is sized from the member's cross-section.

Lapped gooseneck splice joint (koshikake kama-tsugi) X-ray view of a splined opposing joint with pegs

Sill corners, rafter peaks and crossing members

Corner, bridle and cross-lap joints

Corners meet as plain miters, half-laps, dovetails, tongue-and-fork (bridle) rafter peaks, or mitered-and-keyed laps that hide the end grain on the outside of the corner. Crossing timbers half-lap equally or house one member into a dado in the other.

Half-blind cross-lap joint with keys X-ray view of a half-blind cross-lap joint with keys

How Kumiki compares to general-purpose CAD

Mechanical CAD tools model arbitrary solids; Kumiki models timbers, grain direction, reference arrises and joinery rules.

CapabilityKumiki + KigumiOpenSCAD / CadQuerySketchUp / FreeCAD
Built-in wood joinery 30+ parametric joints (M&T, dovetails, scarfs, housings, pegs)Manual CSG boolean cutoutsManual drawing or static plugins
Resizing a timber Shoulders, tenons, pockets and pegs recut automaticallyRequires rewriting coordinate mathOften breaks adjacent faces
Wood grain & local faces First-class grain axis (BOTTOM to TOP) and reference edgesNone (isotropic meshes/BREPs)None
Assembly order verification Computed from joint insertion directions with timeline playbackNoneNone
AI agent authoring Built-in agent, MCP server, exact symbolic rules, headless PNG renderProne to floating-point CSG misalignmentGUI-bound, not text/git native

Questions

Why use Kumiki instead of OpenSCAD, CadQuery, FreeCAD or SketchUp for wood joinery?

In general-purpose CAD, a joint is a boolean subtraction you draw by hand: if you change a post from 4x4 to 6x6 or change a rafter angle, the mortise, shoulder and peg holes break. In Kumiki, every joint is a function of the timbers it connects, so shoulders, housings, tenon thicknesses and clearances recalculate automatically.

Does Kumiki support both Japanese joinery (kigumi) and Western timber framing?

Yes. Kumiki includes traditional Japanese splicing and connecting joints (koshikake kama-tsugi, kanawa-tsugi, ari-otoshi, oire-shiguchi, watari-ago) alongside classic Western square-rule and mill-rule timber framing joints (draw-bored mortise and tenon, tusked tenons, bridle joints, cross-laps and housings).

How do I choose between basic_joints and full joint functions?

Start with cut_basic_* functions (such as cut_basic_mortise_and_tenon_joint_on_face_aligned_timbers). They derive standard carpentry proportions—like a 1/3-width tenon—from the timbers automatically. When you need exact control over shoulder insets, tenon offsets or peg placement, switch to the underlying cut_* function.