diff --git a/pages/common/mods.md b/pages/common/mods.md
new file mode 100644
index 000000000..e8d95ceaa
--- /dev/null
+++ b/pages/common/mods.md
@@ -0,0 +1,32 @@
+# mods
+
+> AI for the command line, built for pipelines.
+> More information: <https://github.com/charmbracelet/mods>.
+
+- Ask a generic question:
+
+`mods "{{write me a poem about platypuses}}"`
+
+- Open settings in your `$EDITOR`:
+
+`mods --settings`
+
+- Ask for comments on your code, in markdown format:
+
+`mods --format "{{what are your thoughts on improving this code?}}" < {{path/to/file}}`
+
+- Ask for help with your documentation, in markdown format:
+
+`mods --format "{{write a new section to this readme for a feature that sends you a free rabbit if you hit r}} < {{README.md}}"`
+
+- Organize your videos, in markdown format:
+
+`ls {{path/to/videos}} | mods --format "{{organize these by decade and summarize}}"`
+
+- Read through raw HTML and summarize the contents, in markdown format:
+
+`curl "{{https://api.open-meteo.com/v1/forecast?latitude=29.00&longitude=-90.00&current_weather=true&hourly=temperature_2m,relativehumidity_2m,windspeed_10m}}" | mods --format "{{summarize this weather data for a human}}"`
+
+- Display help and exit:
+
+`mods --help`