Justfile in Nix projects

SkillDocs & knowledge

Conventions for writing justfile recipes in Nix-based projects.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Justfile in Nix projects skill

What this skill tells your AI

The instructions your AI receives, as published by srid/emanote in .agents/skills/nix-justfile/SKILL.md and read by ahel’s review.

Doc comments

Every recipe must have a doc comment (# line above the recipe name).

Devshell detection

Use a nix_shell variable to auto-detect whether we're inside nix develop:

nix_shell := if env('IN_NIX_SHELL', '') != '' { '' } else { 'nix develop -c' }

Prefix commands that need devshell tools (node, trunk, cargo-watch, etc.) with {{nix_shell}}. Recipes that invoke nix directly (build, run, flake commands) don't need it.

Legibility

Long chained commands should use multiline \ continuations.

Signals

GitHub stars
959
Forks
79
Last commit
Jul 2026

ahel recommends instead

Advanced
Catalog kind
skill
Gateway key
nix-justfile-2
Source
github.com/srid/emanote