# NIXTAMAL(1) | Nixtamal

┏┓╻+╻ ╱┏┳┓┏┓┏┳┓┏┓╻

┃┃┃┃┗━┓╹┃╹┣┫┃┃┃┣┫┃

╹┗┛╹╱ ╹ ╹ ╹╹╹ ╹╹╹┗┛     Home      Install  Manpage  Changelog  Roadmap  Cookbook  Real-world showcase  Community  FAQs  Funding        NIXTAMAL(1)      NAME   nixtamal - fulfilling input pinning for Nix     SYNOPSIS    nixtamal  COMMAND …     LICENSE   GNU General Public License, version 3.0 later

(GPL-3.0-or-later)     MAKER   toastal <https://toast.al/contact/>     FUNDING   See: https://toast.al/funding/     COMMANDS     check-soundness [ OPTION ]…   Checks that the manifest × lockfile is sound.   gc [ OPTION ]…   Garbage collect old generations (experimental). Requires

NIXTAMAL_EXPERIMENTAL_GC to be set & is probably still broken. Keeping

the freshest (configurable) number of generations. We suggest at least 2

if favoring rebase-style workflows so swapping back & forth is less

trouble.   list-stale [ OPTION ]…   List stale inputs with fresh-cmd, without refreshing   lock [ OPTION ]… [ INPUT_NAME ]…   Lock all not-yet-locked inputs.   refresh [ OPTION ]… [ INPUT_NAME ]…   Refreshes all non-frozen inputs using the

fresh-cmd — or the default fresh-cmd for certain

kinds with a reasonable default (Git).   set-up [ OPTION ]…   Set up working directory for Nixtamal. By default, also adds Nixpkgs from

upstream to the project's inputs.   show [ OPTION ]…   Shows current inputs as understood by Nixtamal for earthlings.   tweak [ OPTION ]…   Tweak the manifest file with $VISUAL, $EDITOR, or vi   upgrade [ OPTION ]…   Upgrade lockfile & manifest to current schema version.      COMMON

OPTIONS     --help [= FMT ] (default= auto )  Show this help in format FMT . The value FMT must be one of auto , pager , groff or plain . With auto ,

the format is pager or plain whenever the TERM env

var is dumb or undefined.   --version   Show version information.      EXIT

STATUS    nixtamal exits with:   0  on success.  65  Nixtamal working directory or manifest not set up. Run `nixtamal

set-up`.  66  Version mismatch between manifest and lockfile. Run `nixtamal lock`, but

might require *removing* the lockfile first until `nixtaml fast-forward`

is made.  67  Failed to parse the manifest file.  68  Failed to parse the lockfile.  69  Failed to serialize lockfile.  70  Fresh command execution threw an exception.  71  Fresh command output nothing.  72  Prefetch command threw an exception.  73  Prefetch command output was unusable.  74  Prefetch command flopped on JSON output.  75  Snag when trying to work with the Darcs context.  76  Silo error (such as bad hex in generation number).  77  Version not found or invalid in manifest file.  78  Upgrading Nixtamal failed.  79  BLAKE3 hash algorithm is requested but this Nix doesn’t support

it.  80  Input kind mismatch between manifest & lockfile which prevents values

to be melded.  123  on indiscriminate errors reported on standard error.  124  on command line parsing errors.  125  on unexpected internal errors (bugs).      BUGS   No tracker is set up; contact the maker directly or join the XMPP

chatroom @ <xmpp:nixtamal@chat.toastal.in.th?join>.     SEE

ALSO     nixtamal-manifest(5)   manifest.kdl format         Nixtamal 1.4.1       Site made with Nix ( dep management), Nickel ( config ), Soupault ( SSG ), Docutils ( rST rendering), mandoc (manpage conversion), & sugilite256 (color scheme).  © 2025–2026 toastal .

© 2026 Nixtamal contributors.

Some rights reserved.

Except where otherwise noted, the content on this website is licensed under CC-BY-SA-4.0 .

Citations must attribute the work’s writer/maker & include a hyperlink to this website (or rather the work itself).

Yes, these rules/clauses apply to LLM s & AI assistants too.