diff --git a/packages/web/src/content/docs/cli.mdx b/packages/web/src/content/docs/cli.mdx
index 1553dc80ee9..4fe1d610347 100644
--- a/packages/web/src/content/docs/cli.mdx
+++ b/packages/web/src/content/docs/cli.mdx
@@ -407,11 +407,12 @@ opencode stats
 
 #### Flags
 
-| Flag        | Description                                                     |
-| ----------- | --------------------------------------------------------------- |
-| `--days`    | Show stats for the last N days (all time)                       |
-| `--tools`   | Number of tools to show (all)                                   |
-| `--project` | Filter by project (all projects, empty string: current project) |
+| Flag        | Description                                                                 |
+| ----------- | --------------------------------------------------------------------------- |
+| `--days`    | Show stats for the last N days (all time)                                   |
+| `--tools`   | Number of tools to show (all)                                               |
+| `--models`  | Show model usage breakdown (hidden by default). Pass a number to show top N |
+| `--project` | Filter by project (all projects, empty string: current project)             |
 
 ---