cli-just

Just Command Runner

Create readable task automation that matches the repository's installed Just version and existing justfile conventions.

Defaults

• Inspect just --version, the existing justfile/module tree, and just --list before editing. Installed capabilities and existing syntax are authoritative over this skill's examples.

• Preserve bespoke formatting. Do not rewrite a justfile with just --fmt; use just --fmt --check only when the repository explicitly treats the built-in formatter as authoritative. just --dump is inspection output, not a formatting source.

• Define multi-item string sequences one item per line with a parenthesized concatenation. Keep a trailing separator in every non-final item; do not collapse them into one long string. Triple-quoted strings are for values whose newlines are semantic, not visual wrapping. For example:

  check-steps := (
    "event-class-coverage " +
    "orphan-disposal " +
    "price-coverage"
  )
  

• Prefer explicit, small recipes; Just-native executable checks; private helpers; check/write recipe pairs; and aliases after their target recipes. Prefer which() plus assert() with actionable install guidance over shell command -v or backtick which checks when the justfile already enables set unstable and set lists. Otherwise, use require() when its generic missing-executable error is sufficient. Put an assertion at top level only when every recipe needs that tool; otherwise make it a private prerequisite of the affected recipes.

• Make recipes quiet by default: prefix the recipe name with @ unless echoing commands has clear value. Recipe-level @ inverts per-line @, so never also prefix lines inside a @recipe. Never add @ to a [script] recipe: scripts are already quiet, and @ un-mutes them. See "Quiet Recipes and Command Prefixes" in references/recipes.md.

• On stock macOS, assume /bin/bash 3.2 unless the recipe explicitly selects a newer shell.

• Use the user's section-banner style when creating a new standalone justfile; existing repository organization overrides it.