FSM-based workflow runner for CLI commands, LLM sessions, and native git/GitHub automation. Programs are YAML state machines backed by OTP :gen_statem; nodes run shell commands or LLM agents and return typed outcomes.
Read the Book — install, first program, YAML reference, patterns, and CLI.
curl -fsSL https://raw.githubusercontent.com/Industrial/definitively/main/install.sh | bashPin a release: bash -s -- --version definitively-v0.2.0. See the Install channels chapter for Hex, Nix, Homebrew, and devenv.
| Topic | Book chapter |
|---|---|
| First run | Quick start |
| Workspace setup | .definitively/ layout |
| Write programs | Authoring programs |
| Git and GitHub nodes | Git nodes · gh nodes |
| Git hooks (gate programs) | Hook integration |
| Git/PR/CI pattern | Git and GitHub automation |
| Quality loop example | Dev quality loop |
| CLI reference | Commands and flags |
| Contribute | Developing definitively |
git clone --recurse-submodules git@github.com:Industrial/definitively.git
cd definitively
devenv shelldevenv shell installs git hooks, syncs moon, and puts Elixir, definitively, and graphviz on PATH. Set DEFINITIVELY_FROM_SOURCE=1 to build the CLI from source on shell enter.
moon run definitively:build
mdbook serve book # preview the book locallyContributor details: Developing definitively in the book.
