diff --git a/docs/cli/models.md b/docs/cli/models.md
index 0006cfe0acf..093a0c79a29 100644
--- a/docs/cli/models.md
+++ b/docs/cli/models.md
@@ -47,10 +47,10 @@ Notes:
 - `models list` is read-only: it reads config, auth profiles, existing catalog
   state, and provider-owned catalog rows, but it does not rewrite
   `models.json`.
-- `models list --all` includes provider-owned static catalog rows from plugin
-  manifests or bundled provider catalog metadata even when you have not
-  authenticated with that provider yet. Those rows still show as unavailable
-  until matching auth is configured.
+- `models list --all --provider <id>` can include provider-owned static catalog
+  rows from plugin manifests or bundled provider catalog metadata even when you
+  have not authenticated with that provider yet. Those rows still show as
+  unavailable until matching auth is configured.
 - `models list` keeps native model metadata and runtime caps distinct. In table
   output, `Ctx` shows `contextTokens/contextWindow` when an effective runtime
   cap differs from the native context window; JSON rows include `contextTokens`