diff --git a/pkgs/puppy/README.md b/pkgs/puppy/README.md
new file mode 100644
index 00000000..878276f3
--- /dev/null
+++ b/pkgs/puppy/README.md
@@ -0,0 +1,11 @@
+Activate locally using:
+
+```console
+cd <puppy pkg path>
+dart pub global activate --source=path .
+```
+
+### Tools
+
+- `for_all_package_dirs`: runs a command in every directory containing
+  `pubspec.yaml`.