Day-to-Day Commands

All commands are run via mise tasks defined in mise.toml.

Common Commands

# Apply config on the current machine (auto-detects hostname + platform)
mise run nix:switch

# Debug a failing build (show trace)
mise run nix:debug

# Update all flake inputs
mise run nix:up

# Update a single input
mise run nix:up nixpkgs

# Clean up nix-config history
mise run nix:clean              # default retention: 7d
mise run nix:clean 30d          # keep 30 days of nix-config generations
mise run nix:gc                 # aggressive: free unused store paths across the machine

# Format all .nix files
mise run nix:fmt

# Open a nix repl with the flake loaded
mise run nix:repl

Listing All Tasks

mise tasks

This shows every available task grouped by category. Hidden tasks (internal building blocks) are not shown by default.

Platform Detection

mise run nix:switch and mise run nix:debug automatically detect:

• Hostname from the system
• Platform (darwin vs linux)
• Architecture (aarch64 vs x86_64)

They then run the appropriate build command (darwin-rebuild switch on macOS, system-manager switch + home-manager switch on Linux).

System History

# Show recent system generations
mise run nix:history

This shows the system profile generations for the current machine.

Use mise run nix:clean when you want to trim old nix-config generations without collecting unrelated store paths from other projects.