Document -Q

Author: mxcl

README.md

@@ -153,6 +153,24 @@ myproj $ code .
 
 </details>
 
+## What Can `pkgx` Run?
+
+We have a web based package listing at
+[pkgx.dev/pkgs](https://pkgx.dev/pkgs/).
+
+From the CLI you can use query mode:
+
+```sh
+$ pkgx -Q git
+# ^^ can you run git? (outputs the fully qualified project name)
+
+$ pkgx -Q
+# ^^ list everything that could be run
+
+$ pkgx -Q | grep git-
+# ^^ what git extensions does pkgx provide?
+```
+
 &nbsp;
 
 # The `pkgx` Ecosystem

docs/pkgx.md

@@ -8,6 +8,28 @@ $ pkgx openai --version
 openai 1.59.6
 ```
 
+## Search
+
+Generally you don’t need to search since you already know what you want to
+run, so just type it! Sometimes though you want to browse.
+
+We have a web based package listing at
+[pkgx.dev/pkgs/](https://pkgx.dev/pkgs/). This is the most thorough resource
+at this time.
+
+And from the CLI you can use query mode:
+
+```sh
+$ pkgx -Q git
+# ^^ can we run git?
+
+$ pkgx -Q | grep git-
+# ^^ search for all git extensions
+
+$ $ pkgx -Q
+# ^^ list every program pkgx can run
+```
+
 ## Run Any Version
 
 ```sh