$brew install just
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis
just is a project-local command runner that reads recipes from a justfile and executes them with parameters, dependencies, dotenv loading, and shell integration. It is most useful when a repo wants one discoverable entry point for build, test, deploy, and maintenance commands.
What It Enables
- Define named project tasks once and run them consistently from any subdirectory that can find the repo's
justfile. - List available recipes, inspect recipe definitions, and expose repo automation entry points without reading shell scripts by hand.
- Run build, test, deploy, and maintenance recipes with arguments, dependencies, dotenv loading, or arbitrary shebang languages.
Agent Fit
--list,--summary,--show, and--dump --dump-format jsonmake existing project workflows discoverable and parsable before execution.- Commands are non-interactive by default, honor exit codes, and
--dry-runhelps agents preview effects before running recipes. - Best when a repo already captures useful operations in a
justfile;justis a control layer over project scripts, not a service CLI with a fixed cross-project action surface.
Caveats
- Automation value depends entirely on the local
justfile; a repo with weak or unsafe recipes gives agents little reliable leverage. - Some features lean interactive or human-oriented, such as
--chooseviafzfand--edit, and recipe bodies can run arbitrary shell code.