Scriptbook

Scriptbook runs CentrMark (.cmk) playbooks on your machine and records output in sidecars — never by rewriting the document. Think Jupyter for scripts: narrative + `

step` cells, playable from a CLI (DevCentr GUI later).

* Markup: CentrMark `

playbook` / ::: step (see spec/playbook-profile.adoc)

• Executor: this repo (library + scriptbook CLI)

• Output: <file.cmk>.runs/ (spec/sidecar.adoc)

SLP / `

tangle` is for source literate programming. Scriptbook is for run on my machine docs.

Table of Contents

• Build
• Usage
• Examples
• Install (release)
• License

Build

Requires DUB and a D compiler (DMD or LDC).

cd lib && dub build
cd ../cli && dub build
./bin/scriptbook version

On Windows, binaries land under cli/bin/scriptbook.exe.

Usage

scriptbook run examples/smoke.cmk
scriptbook status examples/smoke.cmk
scriptbook history examples/smoke.cmk
scriptbook prohelp
scriptbook clean-runs examples/smoke.cmk

Flags:

• --yes / -y — allow steps with confirm=true

• --dry-run — record scripts without executing

Commands:

• history — human-readable table of the last sidecar run (was it run? what exited?)

• prohelp — how to find Scriptbook run records and OS audit tools (journalctl / Event Viewer / syslog)

Shell backends (shell= prop): auto (prefer nu, else bash/sh or pwsh), nu, sh, bash, pwsh.

Nushell helpers: nu/scriptbook.nu.

Examples

• examples/smoke.cmk — CI smoke

• examples/gh-pages-https.cmk — Cloudflare ↔ GitHub Pages HTTPS algorithm (see also dev-centr/general-knowledge how-to + scripts/check-gh-pages-https.nu)

Install (release)

Download a binary from GitHub Releases, or build from source as above.

License

Centr Source License 1.0 — Branding (CSL-1.0-B). See LICENSE. Incorporation (linking/bundling in another product) is allowed; Scriptbook branding is reserved. Family overview: DevCentr Licensing.

Previously AGPL-3.0-or-later (through 0.1.1 history); relicensed 2026-08-03. Git history was not rewritten.