From 03cf7da2bdf1db5acc802803b159fcacb74acc12 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Thu, 8 Jan 2026 02:49:29 +0100
Subject: [PATCH] feat: default providers list to usage

---
 docs/cli/index.md               | 4 ++--
 docs/concepts/usage-tracking.md | 2 +-
 src/cli/providers-cli.ts        | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/cli/index.md b/docs/cli/index.md
index 6a827f865..83226ec92 100644
--- a/docs/cli/index.md
+++ b/docs/cli/index.md
@@ -221,8 +221,8 @@ Common options:
 - `--name <label>`: display name for the account
 
 `providers list` options:
-- `--usage`: include provider usage/quota snapshots (OAuth/API-backed only).
-- `--json`: output JSON (includes usage when `--usage` is set).
+- `--no-usage`: skip provider usage/quota snapshots (OAuth/API-backed only).
+- `--json`: output JSON (includes usage unless `--no-usage` is set).
 
 ### `pairing`
 Approve DM pairing requests across providers.
diff --git a/docs/concepts/usage-tracking.md b/docs/concepts/usage-tracking.md
index b9e0b64f6..9921567c5 100644
--- a/docs/concepts/usage-tracking.md
+++ b/docs/concepts/usage-tracking.md
@@ -13,7 +13,7 @@ read_when:
 ## Where it shows up
 - `/status` in chats: adds a short “Usage” line (only if available).
 - CLI: `clawdbot status --usage` prints a full per-provider breakdown.
-- CLI: `clawdbot providers list --usage` prints the same usage snapshot alongside provider config.
+- CLI: `clawdbot providers list` prints the same usage snapshot alongside provider config (use `--no-usage` to skip).
 - macOS menu bar: “Usage” section under Context (only if available).
 
 ## Providers + credentials
diff --git a/src/cli/providers-cli.ts b/src/cli/providers-cli.ts
index ce9c759c8..1d7ad1a4a 100644
--- a/src/cli/providers-cli.ts
+++ b/src/cli/providers-cli.ts
@@ -51,7 +51,7 @@ export function registerProvidersCli(program: Command) {
   providers
     .command("list")
     .description("List configured providers + auth profiles")
-    .option("--usage", "Show provider usage/quota snapshots", false)
+    .option("--no-usage", "Skip provider usage/quota snapshots")
     .option("--json", "Output JSON", false)
     .action(async (opts) => {
       try {