---
name: "just"
section: "1"
platform: "linux"
package: "just"
version: "1.59.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/just"
---

# just(1)

🤖 Just a command runner - https://github.com/casey/just

## NAME

just - 🤖 Just a command runner - https://github.com/casey/just

## SYNOPSIS

**just** \[**--alias-style**\] \[**--allow-missing**\] \[**--ceiling**\] \[**--check**\] \[**--chooser**\] \[**--clear-shell-args**\] \[**--color**\] \[**--command-color**\] \[**--complete-aliases**\] \[**--cygpath**\] \[**--default-list**\] \[**--dotenv-command**\] \[**-F**\|**--dotenv-filename**\] \[**-E**\|**--dotenv-path**\] \[**-n**\|**--dry-run**\] \[**--dump-format**\] \[**--evaluate-format**\] \[**--explain**\] \[**-g**\|**--global-justfile**\] \[**--group**\] \[**--highlight**\] \[**--indentation**\] \[**--jobs**\] \[**-f**\|**--justfile**\] \[**--justfile-name**\] \[**--list-heading**\] \[**--list-prefix**\] \[**--list-submodules**\] \[**--no-aliases**\] \[**--no-cache**\] \[**--no-deps**\] \[**--no-dotenv**\] \[**--no-highlight**\] \[**--one**\] \[**-q**\|**--quiet**\] \[**--set**\] \[**--shell**\] \[**--shell-arg**\] \[**--shell-command**\] \[**--changelog**\] \[**--choose**\] \[**--clean**\] \[**-c**\|**--command**\] \[**--completions**\] \[**--dump**\] \[**-e**\|**--edit**\] \[**--evaluate**\] \[**--fmt**\] \[**--groups**\] \[**--init**\] \[**--json**\] \[**-l**\|**--list**\] \[**--man**\] \[**-s**\|**--show**\] \[**--summary**\] \[**--usage**\] \[**--variables**\] \[**--tempdir**\] \[**--time**\] \[**--timestamp**\] \[**--timestamp-format**\] \[**-u**\|**--unsorted**\] \[**--unstable**\] \[**-v**\|**--verbose**\]... \[**-d**\|**--working-directory**\] \[**--yes**\] \[**-h**\|**--help**\] \[**-V**\|**--version**\] \[*ARGUMENTS*\]

## DESCRIPTION

🤖 Just a command runner - https://github.com/casey/just

## OPTIONS

- **--alias-style** *\<ALIAS\_STYLE\>* \[default: right\]

  Set list command alias display style\

  *Possible values:*

  - •

    left

  - •

    right

  - •

    separate

- **--allow-missing**

  Ignore missing recipe and module errors

- **--ceiling** *\<CEILING\>*

  Do not ascend above \<CEILING\> directory when searching for a justfile.

- **--check**

  Run \`--fmt\` in 'check' mode. Exits with 0 if justfile is formatted correctly. Exits with 1 and prints a diff if formatting is required.

- **--chooser** *\<CHOOSER\>*

  Override binary invoked by \`--choose\`

- **--clear-shell-args**

  Clear shell arguments

- **--color** *\<COLOR\>* \[default: auto\]

  Print colorful output\

  *Possible values:*

  - •

    always

  - •

    auto

  - •

    never

- **--command-color** *\<COMMAND\_COLOR\>*

  Echo recipe lines in \<COMMAND-COLOR\>\

  *Possible values:*

  - •

    black

  - •

    blue

  - •

    cyan

  - •

    green

  - •

    purple

  - •

    red

  - •

    yellow

- **--complete-aliases**

  Auto-complete recipe aliases

- **--cygpath** *\<CYGPATH\>* \[default: cygpath\]

  Use binary at \<CYGPATH\> to convert between unix and Windows paths

- **--default-list**

  List recipes when no arguments are provided

- **--dotenv-command** *\<COMMAND\>*

  Run \<COMMAND\> and load its output as an environment file

- **-F**, **--dotenv-filename** *\<DOTENV\_FILENAME\>*

  Search for an environment file named \<DOTENV-FILENAME\> instead of \`.env\`

- **-E**, **--dotenv-path** *\<DOTENV\_PATH\>*

  Load \<DOTENV-PATH\> as an environment file instead of searching for one

- **-n**, **--dry-run**

  Print what just would do without doing it

- **--dump-format** *\<FORMAT\>* \[default: just\]

  Dump justfile as \<FORMAT\>\

  *Possible values:*

  - •

    json

  - •

    just

- **--evaluate-format** *\<FORMAT\>* \[default: just\]

  Print evaluated variables in \<FORMAT\>\

  *Possible values:*

  - •

    just

  - •

    shell

- **--explain**

  Print recipe doc comment before running it

- **-g**, **--global-justfile**

  Use global justfile

- **--group** *\<GROUP\>*

  Only list recipes in \<GROUP\>

- **--highlight**

  Highlight echoed recipe lines in bold

- **--indentation** *\<INDENTATION\>*

  Indent recipes bodies with \<INDENTATION\>

- **--jobs** *\<N\>*

  Run at most \<N\> recipes simultaneously with the \[parallel\] attribute

- **-f**, **--justfile** *\<JUSTFILE\>*

  Use \<JUSTFILE\> as justfile or \`-\` to read from standard input

- **--justfile-name** *\<NAME\>*

  Search for justfile named \<NAME\>, accepts multiple \`,\`-separated values and may be repeated

- **--list-heading** *\<TEXT\>* \[default: Available recipes:\\n\]

  Print \<TEXT\> before list

- **--list-prefix** *\<TEXT\>* \[default: \]

  Print \<TEXT\> before each list item

- **--list-submodules**

  List recipes in submodules

- **--no-aliases**

  Don't show aliases in list

- **--no-cache**

  Bypass recipe cache

- **--no-deps**

  Don't run recipe dependencies

- **--no-dotenv**

  Don't load \`.env\` file

- **--no-highlight**

  Don't highlight echoed recipe lines in bold

- **--one**

  Forbid multiple recipes from being invoked on the command line

- **-q**, **--quiet**

  Suppress all output

- **--set** *\<VARIABLE\> \<VALUE\>*

  Override \<VARIABLE\> with \<VALUE\>

- **--shell** *\<SHELL\>*

  Invoke \<SHELL\> to run recipes

- **--shell-arg** *\<SHELL\_ARG\>*

  Invoke shell with \<SHELL-ARG\> as an argument

- **--shell-command**

  Invoke \<COMMAND\> with the shell used to run recipe lines and backticks

- **--tempdir** *\<TEMPDIR\>*

  Save temporary files to \<TEMPDIR\>.

- **--time**

  Print recipe execution time

- **--timestamp**

  Print recipe command timestamps

- **--timestamp-format** *\<TIMESTAMP\_FORMAT\>* \[default: %H:%M:%S\]

  Timestamp format string

- **-u**, **--unsorted**

  Return list and summary entries in source order

- **--unstable**

  Enable unstable features

- **-v**, **--verbose**

  Use verbose output

- **-d**, **--working-directory** *\<WORKING\_DIRECTORY\>*

  Use \<WORKING-DIRECTORY\> as working directory

- **--yes**

  Automatically confirm all recipes.

- **-h**, **--help**

  Print help

- **-V**, **--version**

  Print version

- \[*ARGUMENTS*\]

  Overrides and recipe(s) to run, defaulting to the first recipe in the justfile

## COMMANDS

- **--changelog**

  Print changelog

- **--choose**

  Select one or more recipes to run using a binary chooser. If \`--chooser\` is not passed the chooser defaults to the value of $JUST\_CHOOSER, falling back to \`fzf\`

- **--clean** \[*\<RECIPE\_PATH\>...*\]

  Clear recipe cache, optionally restricted to recipes whose path begins with \<RECIPE\_PATH\>

- **-c**, **--command** *\<COMMAND\>...*

  Run an arbitrary command with the working directory, \`.env\`, overrides, and exports set

- **--completions** *\<SHELL\>*

  Print shell completion script for \<SHELL\>\

  *Possible values:*

  - •

    bash

  - •

    elvish

  - •

    fish

  - •

    nushell

  - •

    powershell

  - •

    zsh

- **--dump**

  Print justfile

- **-e**, **--edit**

  Edit justfile with editor given by $VISUAL or $EDITOR, falling back to \`vim\`

- **--evaluate**

  Evaluate and print all variables. If a variable name is given as an argument, only print that variable's value.

- **--fmt**

  Format and overwrite justfile

- **--groups**

  List recipe groups

- **--init**

  Initialize new justfile in project root

- **--json**

  Print justfile as JSON

- **-l**, **--list** \[*\<MODULE\>...*\]

  List available recipes in \<MODULE\> or root if omitted

- **--man**

  Print man page

- **-s**, **--show** *\<RECIPE\_PATH\>...*

  Show recipe at \<RECIPE\_PATH\>

- **--summary**

  List names of available recipes

- **--usage** \[*\<PATH\>...*\]

  Print usage information for recipe at \<PATH\> or all recipes in module at \<PATH\>, defaulting to all recipes in the root justfile

- **--variables**

  List names of variables

## VERSION

v1.59.0

## AUTHORS

Casey Rodarmor \<casey@rodarmor.com\>