diff --git a/packages/web/src/content/docs/cli.mdx b/packages/web/src/content/docs/cli.mdx
index c0fbbd3b..5d2ac4a7 100644
--- a/packages/web/src/content/docs/cli.mdx
+++ b/packages/web/src/content/docs/cli.mdx
@@ -144,6 +144,8 @@ opencode models
 
 This command displays all models available across your configured providers in the format `provider/model`.
 
+This is useful for figuring out the exact model name to use in [your config](/docs/config/).
+
 ---
 
 ### run