applicative-systems/gcan

Nix is a package manager that stores everything it installs in a special folder called the Nix store. Over time this folder can grow to take up many gigabytes of disk space. Nix has a built-in garbage collection command to clean it up, but it often frees very little because things called GC roots are holding onto data. A GC root is any pointer that tells Nix to keep something: a symlink left over from a build, a directory-specific environment managed by a tool called direnv, an old version of your installed software profile, and so on. gcan (pronounced like the question "g-can") is a tool that shows you all these GC roots sorted by how much disk space each one is actually keeping alive. This is different from how large the root itself is: a tiny symlink can pin a 5 GB dependency tree. The tool shows you the true cost of each root, where it lives on disk, and how old it is, so you can make informed decisions about what to remove. The tool has three modes. The list command prints a table of roots you can safely delete, with options to filter by minimum size and minimum age. The delete command removes roots that match filters you specify, optionally running garbage collection afterward to actually reclaim the disk space. The tui command opens a full-screen keyboard-driven interface where you can browse, sort, and delete roots interactively without typing repeated commands. For projects using direnv, which creates per-project Nix environments, gcan groups all the roots from the same project directory into one line so you see the total cost per project rather than dozens of individual cryptic hashes. The tool is designed to be safe by default. It never offers to delete system roots, the currently running system generation, or anything root-owned. Deletions through the interactive interface and the delete command both ask for confirmation first. JSON output and plain path output are available for use in scripts. The project is built in Rust, released under the MIT license, and developed by Applicative Systems.