Just
Apps & AutomationjustJust is an Agent Skill for apps & automation published in the casey/just repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Reference for `just`, the command runner. Use when working in a project with a `justfile` or when the user mentions `just` or `justfile`.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/casey/just/blob/HEAD/skills/just/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/just, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Just
Discovery
just --dumpPrint justfilejust --evaluatePrint variable valuesjust --helpPrint detailed command-line syntax helpjust --listPrint recipes with descriptionsjust --show <RECIPE>Print recipe sourcejust --summaryPrint recipes without descriptiosn
Execution
justRun default recipejust <RECIPE>Run specific recipejust <RECIPE> <ARG1> <ARG2Run recipe with arguments
Syntax
executable := 'main'
# compile main.c
compile:
cc main.c -o {{ executable }}
# run main
run: compile
./{{ executable }}
# run test
test name: compile
./bin/test {{ name }}
# start webserver
serve port='8080':
python -m http.server {{port}}
# publish current tag
publish:
#!/usr/bin/env bash
set -euxo pipefail
tag=`git describe --tags --exact-match`
./bin/check-tag $tag
git push origin $tag
Notes
The comment proceeding a recipe is used as its doc-comment, and included in
just --list.
By default, each line of a recipe runs in a fresh shell. Recipes whose bodies
start with #! are written to a file and executed as a script.
Commonly used commands and scripts should be turned into just recipes.