WindowsmacOSLinux

Where Does Just Store Recipes and Config?

Just justfile plus config inside your project on Windows, macOS and Linux.

Last updated

Just reads recipes from justfile or .justfile at the project root. User config lives in the home config dir when set.

There is no build output of its own. The project folder is portable. Moving machines needs only the repo; Just itself installs per OS. Aliases stay in shell files, not Just.

Where Just stores this, by platform

Windows
[ProjectDir]\justfile

Recipes at root (also .justfile). User config optionally in %APPDATA%\just\. Keep justfile in git; it is the whole automation story.

macOS
[ProjectDir]/justfile

Same in-folder layout. User overrides sit in ~/.config/just/ when used. Fresh clones run with only Just installed.

Linux
[ProjectDir]/justfile

Same arrangement. System wide config rarely matters. Commit justfile plus .justfile variants; ignore any local env files.

Frequently asked questions

Where is the Just config?

The justfile at the project root. That file lists every recipe. Global config is optional and lives in the home just dir when present.

just says no justfile found. What now?

Run from the project root or pass the justfile flag with a path. Nested folders inherit upward unless a closer justfile exists.

Notice an outdated path? Let us know.