id       = "just"
name     = "just"
homepage = "https://just.systems"
description = "just is a handy way to save and run project-specific commands."
icon     = "SimpleIcons:just"
executables   = ["just"]

[dotfiles]

# https://github.com/casey/just#global-and-user-justfiles — with --global-justfile
# (-g) just looks for, in order, $XDG_CONFIG_HOME/just/justfile,
# $HOME/.config/just/justfile, $HOME/justfile and $HOME/.justfile, on every
# platform. Per-project justfiles live in the repository and are not user config.
paths = [
  "~/.config/just/justfile",
  "~/justfile",
  "~/.justfile",
]

exclude = []

# A justfile is a list of recipes. just has no credential store; anything
# secret a recipe needs comes from the environment or a project .env.
secret = []

# Parsed at the start of every `just` invocation.
side_effect = false

# No machine_lines: the recipes in a user justfile are the commands the user
# wants everywhere, which is the whole point of the global justfile.

[commands]
format = 1
label = "Run recipes"
description = "Run recipes from a justfile, list them or show one. Formatting, dump and variable-setting options are left out."
quality = "ai-draft"
base = "fig:just"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/just.ts"
license = "MIT"

[[commands.field]]
id = "recipe"
label = "Recipe and arguments"
type = "string"
position = 0
multiple = true
description = "Recipe names followed by their arguments; empty runs the default recipe."
sources = ["fig"]

[[commands.field]]
id = "justfile"
label = "Justfile"
type = "path"
option = ["--justfile", "-f"]
description = "Use a specific justfile."
path = { kind = "file", role = "input" }
sources = ["fig"]

[[commands.field]]
id = "working_directory"
label = "Working directory"
type = "path"
option = ["--working-directory", "-d"]
description = "Use this as the working directory."
path = { kind = "directory", role = "input" }
sources = ["fig"]

[[commands.field]]
id = "list"
label = "List recipes"
type = "boolean"
option = ["--list", "-l"]
description = "List available recipes and their arguments."
sources = ["fig"]

[[commands.field]]
id = "show"
label = "Show recipe"
type = "string"
option = ["--show", "-s"]
description = "Show information about a recipe."
sources = ["fig"]

[[commands.field]]
id = "summary"
label = "Summary"
type = "boolean"
option = ["--summary"]
description = "List names of available recipes."
sources = ["fig"]

[[commands.field]]
id = "dry_run"
label = "Dry run"
type = "boolean"
option = ["--dry-run"]
description = "Print what just would do, without doing it."
sources = ["fig"]

[[commands.field]]
id = "quiet"
label = "Quiet"
type = "boolean"
option = ["--quiet", "-q"]
description = "Suppress all output."
sources = ["fig"]

[[commands.field]]
id = "verbose"
label = "Verbose"
type = "boolean"
option = ["--verbose", "-v"]
description = "Use verbose output."
sources = ["fig"]

[[commands.field]]
id = "unsorted"
label = "Source order"
type = "boolean"
option = ["--unsorted", "-u"]
description = "Return list and summary entries in source order."
sources = ["fig"]

[[commands.task]]
id = "run"
label = "Run a recipe"
fields = ["recipe", "justfile", "working_directory", "dry_run", "verbose"]
required = ["recipe"]

[[commands.task]]
id = "list"
label = "List recipes"
set = { list = [true] }
fields = ["justfile", "working_directory", "unsorted"]
required = []

[[commands.task]]
id = "show"
label = "Show a recipe"
fields = ["show", "justfile", "working_directory"]
required = ["show"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["recipe", "justfile", "working_directory", "list", "show", "dry_run"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["summary", "quiet", "verbose", "unsorted"]