writfold

Earlier work · frozen demos

Frozen demos.
Still runnable.

Before 11 November 2026, Writfold was built as an evidence-and-approval layer for agent edits. That work still builds and runs from source, and gets no new development. Tuft and Splicery are frozen as languages but have adapters into the preview. Writfold’s direction is now project continuity for coding agents.

Source-only preview v0.1.0-dev.1 · Linux x86_64 and WSL2

Read on

The demos and their guides

How the edit trial worksThe six steps, evidence, contexts, architecture and how we know Tuft by exampleFind exact text in a pinned commit, cite it, see budgets and refusals. The query language is frozen at v0; the preview reaches it through writfold tuft run --cite Weft by exampleState assumptions, run checks, read the outcomes Splicery by exampleSelect exact bytes, preview a candidate, see refusals. The language is frozen; the preview reaches it through writfold kb edit apply GlossaryTerms used on these pages: owner, citation, grant, hypothetical and more

Try it

Build and run from source

These demos build from source; the preview binary is for project continuity. Linux x86_64 with rustup; the pinned toolchain installs on first build. These are the commands from the Writfold README at tag v0.1.0-dev.1.

# In a clone of https://github.com/writfold-dev/writfold
cargo build --release -p writfold

# Prepare, approve and apply one edit
export WRITFOLD_STATE=/tmp/writfold-trial
target/release/writfold trial init
target/release/writfold trial prepare --repo /path/to/repo --file src/lib.rs --recipe edit.spl
target/release/writfold trial approve <run>
target/release/writfold trial apply <run>
git -C "$WRITFOLD_STATE/worktrees/<run>" diff

# Find and cite exact evidence with Tuft
printf '@h := find text "trial_blob(" in "crates/" at "%s";\n@e := retain @h around lines 0;\n@v := project @e [path, line, binding, excerpt(max_chars: 72)] limit 6;\nemit @v budget_tokens 300;\n' "$(git rev-parse HEAD)" > q.tuft
target/release/writfold tuft run q.tuft --repo .

Writfold makes its own sparse worktree of the repository's HEAD and never writes your checkout. writfold trial recover <run> settles an interrupted apply. Details are in the trial profile; Weft and Splicery each have their own Try it: Weft, Splicery.

This is a cooperating single-user trial for repositories and data you can delete and recreate. It never writes your checkout, but nothing stops an agent's own shell from doing so, and it assumes nobody races it on its worktree.