Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Task Reference

All tasks are defined in mise.toml and are safest to run as mise run <task>.

Bootstrap & Host Management

TaskDescription
nix:initFull bootstrap pipeline (install nix, add host, activate)
add-hostCreate a new host directory from template
install-nixInstall Nix via nix-installer (hidden)
github-authAuthenticate with GitHub CLI (hidden)
activateBuild and activate the current machine’s config (hidden)

Day-to-Day

TaskDescription
nix:switchApply config on the current machine
nix:debugApply config with --show-trace for debugging
nix:dry-runDry-run a build target or the current host config
nix:check-cacheCheck whether a store path exists in configured substituters
nix:deployBuild locally and deploy system config to a remote Linux host

Maintenance

TaskDescription
nix:upUpdate a single flake input, or all inputs if none specified
nix:historyList system profile generations via nix-env
nix:replOpen a nix repl with nixpkgs
nix:cleanRemove system generations older than a retention window
nix:gcGarbage-collect unused store entries across the machine
nix:gcrootList auto GC roots
nix:fmtFormat all .nix files with the configured formatter
nix:trustAdd current user to Nix trusted-users
nix:uninstallFully uninstall Nix from the system

iTerm2

TaskDescription
iterm:exportRe-export iTerm2 preferences plist

Apple Container Tests (macOS only)

TaskDescription
test:bootstrapRun Linux bootstrap validation in an Apple container

Documentation

TaskDescription
docs:buildBuild the mdBook documentation site
docs:serveServe docs locally with hot-reload

Hidden helper tasks also exist for bootstrap flow: install-nix, github-auth, add-host, and activate.