OpenParable
Skip to content
← Back to skills

Just

Apps & Automation
just

Just 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`.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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 --dump Print justfile
  • just --evaluate Print variable values
  • just --help Print detailed command-line syntax help
  • just --list Print recipes with descriptions
  • just --show <RECIPE> Print recipe source
  • just --summary Print recipes without descriptiosn

Execution

  • just Run default recipe
  • just <RECIPE> Run specific recipe
  • just <RECIPE> <ARG1> <ARG2 Run 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.