rod cheat sheet

Every operation of rod 0.1.0. NAME is a package, @SET a file in /etc/rod/sets. Details and error messages are in rod.

Packages

Task	Command
Fetch the package index	`rod +s`
Pin the index to a nixpkgs commit	`rod +s REV` (40 lowercase hex characters)
Show the pin	`rod +p`
Install	`rod +i NAME...`
Install a set	`rod +i @SET`
Install a set without some members	`rod +i @SET -i NAME...`
Remove	`rod +r NAME...`
Remove a set but keep some members	`rod +r @SET -r NAME...`
Install again	`rod +r NAME +i NAME`
Hold at the current version	`rod +t NAME...`
Release a hold	`rod -t NAME...`
Upgrade everything not held	`rod +u`
Delete what nothing uses	`rod +c`, and `rod +c old` with old generations

Look

Task	Command
Search	`rod +f WORD`
Show a package of the index	`rod +n NAME`
List installed	`rod +l`
List what you asked for	`rod +l explicit`
Preview an upgrade	`rod +h`
Which package owns a file	`rod +w PATH`
What a package needs	`rod +y NAME`
What needs a package	`rod -y NAME`
Size of the profile or of packages	`rod +z [NAME...]`
List the files of a package	`rod +q NAME`
Why a package is installed	`rod +x NAME`
Check installed files	`rod +k`

Try, share, preview

Task	Command
Run without installing	`rod +e NAME -- COMMAND`
Shell with a compiler	`rod +d NAME`
Preview install, remove or upgrade	`rod -n +i NAME`, `rod -n +r NAME`, `rod -n +u`
Write the installed set to a file	`rod +o FILE`
Install from such a file	`rod +a FILE`

Go back

Task	Command
List frames	`scram roll`
Return to a frame	`scram flash --boot FRAME`, or a frame in the boot menu
Apply a pending update	`scram commit --boot`

-i and -r work only directly after +i and +r, and a name they take has to come from a package or set on the line. One line can hold several operations: rod +r htop +i htop.