From 34024c2504d1bdb105e217f5351fd1cb5d7b50a9 Mon Sep 17 00:00:00 2001
From: "opencode-agent[bot]"
 <219766164+opencode-agent[bot]@users.noreply.github.com>
Date: Mon, 15 Dec 2025 18:04:47 -0600
Subject: docs:  models --refresh flag in cli.mdx (#5596)

Co-authored-by: opencode-agent[bot] <opencode-agent[bot]@users.noreply.github.com>
Co-authored-by: rekram1-node <rekram1-node@users.noreply.github.com>
---
 packages/web/src/content/docs/cli.mdx | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

(limited to 'packages/web/src/content/docs/cli.mdx')

diff --git a/packages/web/src/content/docs/cli.mdx b/packages/web/src/content/docs/cli.mdx
index 64e11ff56..777d377a7 100644
--- a/packages/web/src/content/docs/cli.mdx
+++ b/packages/web/src/content/docs/cli.mdx
@@ -161,13 +161,32 @@ opencode github run
 List all available models from configured providers.
 
 ```bash
-opencode models
+opencode models [provider]
 ```
 
 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/).
 
+You can optionally pass a provider ID to filter models by that provider.
+
+```bash
+opencode models anthropic
+```
+
+#### Flags
+
+| Flag        | Description                                                  |
+| ----------- | ------------------------------------------------------------ |
+| `--refresh` | Refresh the models cache from models.dev                     |
+| `--verbose` | Use more verbose model output (includes metadata like costs) |
+
+Use the `--refresh` flag to update the cached model list. This is useful when new models have been added to a provider and you want to see them in OpenCode.
+
+```bash
+opencode models --refresh
+```
+
 ---
 
 ### run
-- 
cgit v1.2.3

