Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Quick start

Get definitively installed, scaffold a workspace, and run the example program.

Install

The fastest path is the curl installer (Linux x86_64 or macOS arm64):

curl -fsSL https://raw.githubusercontent.com/Industrial/definitively/main/install.sh | bash

Pin a release:

curl -fsSL https://raw.githubusercontent.com/Industrial/definitively/main/install.sh | bash -s -- --version definitively-v0.2.0

Other channels (Hex, Nix, Homebrew) are in Install channels.

Scaffold a workspace

From your project root:

cd /path/to/your/repo
definitively init

This copies templates into .definitively/ (skips existing files). Use --force to overwrite.

Run the example program

Programs must live under .definitively/:

definitively run "$PWD/.definitively/programs/example.yml"

On success you see workflow finished and exit code 0.

Visualize the workflow

Default mode writes DOT and PNG under .definitively/visualizations/:

definitively visualize "$PWD/.definitively/programs/example.yml"

Requires Graphviz dot for PNG; DOT is always written.

Next steps