Document search command and command aliases in README

andrew · andrew · commit e9e9656fce86 · 2026-02-06T21:27:38.000Z
diff --git a/README.md b/README.md
@@ -426,6 +426,16 @@ Gemfile.lock:142:    rails (7.0.8)
 
 Like `grep` but scoped to manifest files that git-pkgs knows about.
 
+### Search dependencies
+
+```bash
+git pkgs search rails            # find dependencies matching a pattern
+git pkgs search react --ecosystem=npm
+git pkgs search "^post" --direct # only direct dependencies, not lockfile
+```
+
+Searches the database for dependencies whose names match the given pattern. Shows the matching name, version requirement, ecosystem, and when the dependency was first seen and last changed.
+
 ### List commits with dependency changes
 
 ```bash
@@ -573,6 +583,17 @@ eval "$(git pkgs completions zsh)"
 git pkgs completions install
 ```
 
+### Aliases
+
+Common commands have shorter alternatives:
+
+- `ls` for `list`
+- `rm` for `remove`
+- `grep` for `search`
+- `find` for `where`
+- `audit` for `vulns`
+- `praise` for `blame`
+
 ## Configuration
 
 git-pkgs respects [standard git configuration](https://git-scm.com/docs/git-config).
