Purpose
Create, edit, and operate justfile recipes safely and predictably.
Scope
Covers justfile syntax, execution rules, parameters, substitutions, attributes, modules, and common CLI discovery flags. It does not cover installing just or repository-specific policies beyond linked sources.
Minimal Path
- •Inspect current recipes:
just --listandjust --show <recipe>. - •Author or edit a recipe using standard syntax and grouping attributes.
- •Validate parameters and quoting, especially for arguments that may contain spaces.
- •Run the recipe and verify dependencies, working directory, and execution mode.
- •If complexity grows, split into modules and update module invocation.
Validation
- •
just --listshows expected recipes and groups. - •
just --show <recipe>reflects intended commands. - •Running the recipe succeeds with expected output and side effects.
Failure Modes
- •Parameters split unexpectedly due to missing quotes.
- •Recipes rely on shell state across lines without using
[script]. - •Module recipes fail due to working directory assumptions.
References
- •Context7 MCP: just manual (
just_systems_man_en)