werk

There is always a gap between what exists and what is desired.

Most tools hide this gap behind dashboards and progress bars. werk makes it structural — a tension you hold, observe, and work with until resolution comes or the desire changes.

This is the practice of structural dynamics: the discipline of creating outcomes by honestly holding the relationship between current reality and a desired state.

werk is the instrument.

Tension #2 Desired: werk is a mature tool for practicing structural dynamics Reality: v1.5 — logbase, split/merge, 35 MCP tools, three surfaces Status: Active Created: 5 weeks ago Deadline: 2026-06 Closure: [9/18] Position: 1 Last act: today Signals: ‡ CRITICAL #13 matches or exceeds deadline ┃ SPINE on longest structural path ◎ REACH 110 transitive descendants

architecture of space

Where things are. Dimensions, positions, containment. The one spatial law: desired above actual.

grammar of action

What you can do. Gesture primitives — add, desire, reality, resolve. Every mutation is a gesture.

calculus of time

When things matter. Deadlines, urgency, temporal pressure. Two inputs from you, six computed properties.

logic of framing

What’s visible and why. Envelope, zoom, signal thresholds. Structure determines what surfaces.

begin

# install
cargo install werk

# create your first tension
werk add "what you want to exist"

# describe what actually exists
werk reality 1 "what is true right now"

# see the structure
werk tree

Three commands. You’re practicing.

Read the concepts to understand the foundation, or follow the guide to start immediately.