README

diff --git a/README.md b/README.md
new file mode 100644 (file)
index 0000000..21bb117
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+# Nix Profile GC
+
+Clean up old profiles more carefully than `nix-collect-garbage --delete-older-than`
+
+This module removes most old profiles, but makes sure to keep around the last few profiles that
+served this machine well -- profiles this machine ran on for a (configurable) time -- even if
+they're old.
+
+This is a NixOS Module rather than a stand-alone tool because it determines which extra profiles
+need preserving by periodically logging the currently-active profiles.
+
+See also: [Announcement](https://scottworley.com/blog/2023-05-19-nix-profile-gc.html)