diff --git a/src/content/docs/agents/cli/models-and-usage.mdx b/src/content/docs/agents/cli/models-and-usage.mdx
index 41b14f6f1..ce52d9523 100644
--- a/src/content/docs/agents/cli/models-and-usage.mdx
+++ b/src/content/docs/agents/cli/models-and-usage.mdx
@@ -41,8 +41,9 @@ The CLI loads the same router definitions as the Warp app. These are YAML files
 
 ## Usage and cost
 
-The CLI shows usage at two levels:
+The CLI shows usage at three levels:
 
+* **Account usage** - Run `/usage` to open a read-only panel with your plan, credit balances and consumption, and links to manage billing or upgrade. Press `Esc` to close it. Unlike `/cost`, this is account-level, not conversation-level.
 * **Conversation total** - Once a conversation has reported any usage, the [statusline](/agents/cli/configuration/#statusline) shows its accumulated credits (e.g., `2.5 credits`). Click the entry to switch between credits and the equivalent provider cost in dollars. Your choice persists across sessions.
 * **Per-response details** - Run `/cost` to toggle a summary row under the latest response showing how long it took and how many credits it spent (e.g., `12s • 1.2 credits`). The summary appears once the response finishes.
 
diff --git a/src/content/docs/agents/cli/reference.mdx b/src/content/docs/agents/cli/reference.mdx
index 02fd7dd6b..d81d49327 100644
--- a/src/content/docs/agents/cli/reference.mdx
+++ b/src/content/docs/agents/cli/reference.mdx
@@ -148,6 +148,7 @@ Type `/` at the start of the input to open the slash command menu. Commands that
 | `/statusline` | | Configure the statusline |
 | `/theme` | `<auto\|light\|dark>` | Set the color theme |
 | `/upgrade` | | Open the Warp upgrade page in the browser |
+| `/usage` | | View plan, credit usage, and billing links |
 | `/view-logs` | | Bundle your logs into a zip archive |
 | `/vim-mode` | | Toggle Vim keybindings in the input |
 | `/voice` | | Start voice input |
@@ -156,6 +157,8 @@ Some commands appear only when they apply to your account. `/manage-billing` is
 
 `/status` opens a read-only panel with the installed version, the current conversation's name and ID, the working directory, and the organization and email you're signed in as. Press `Esc` to close it, and include those details when you report a problem.
 
+`/usage` opens a read-only panel with your plan, credit balances and consumption, and links to manage billing or upgrade. See [models and usage](/agents/cli/models-and-usage/#usage-and-cost).
+
 Skills also appear in the same menu under their own names, so you can invoke a skill directly as `/skill-name`. [Customizing the CLI](/agents/cli/configuration/) covers how skills are discovered.
 
 ## Keyboard shortcuts