Something went wrong. Try again.
npx ccusage
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432{ "agent_options": [ { "flags": "-j, --json", "description": "Output in JSON format", "default": "false" }, { "flags": "-s, --since <since>", "description": "Filter from date (YYYY-MM-DD or YYYYMMDD)" }, { "flags": "-u, --until <until>", "description": "Filter until date (inclusive)" }, { "flags": "-z, --timezone <timezone>", "description": "Timezone for date grouping (IANA)" }, { "flags": "-O, --offline", "description": "Use cached pricing data instead of fetching from LiteLLM", "default": "false" }, { "flags": "--no-offline", "description": "Negatable of -O, --offline" }, { "flags": "--compact", "description": "Force compact table layout for narrow terminals", "default": "false" }, { "flags": "--no-cost", "description": "Hide cost information in table and JSON output", "default": "false" }, { "flags": "--color", "description": "Enable colored output. FORCE_COLOR=1 has the same effect.", "default": "auto" }, { "flags": "--no-color", "description": "Disable colored output. NO_COLOR=1 has the same effect.", "default": "auto" }, { "flags": "--config <config>", "description": "Path to configuration file", "default": "auto-discovery" }, { "flags": "-h, --help", "description": "Display this help message" }, { "flags": "-v, --version", "description": "Display this version" } ], "all_agent_options": [ { "flags": "-j, --json", "description": "Output in JSON format", "default": "false" }, { "flags": "-s, --since <since>", "description": "Filter from date (YYYY-MM-DD or YYYYMMDD)" }, { "flags": "-u, --until <until>", "description": "Filter until date (inclusive)" }, { "flags": "-z, --timezone <timezone>", "description": "Timezone for date grouping (IANA)" }, { "flags": "--all", "description": "Accepted for compatibility; all detected supported agents are included by default", "default": "false" }, { "flags": "--sections <sections>", "description": "Emit multiple unified report sections from one load (daily, weekly, monthly, session)" }, { "flags": "--by-agent", "description": "Include per-agent JSON breakdowns in unified report rows", "default": "false" }, { "flags": "-O, --offline", "description": "Use cached pricing data where supported", "default": "false" }, { "flags": "--no-offline", "description": "Negatable of -O, --offline" }, { "flags": "--compact", "description": "Force compact table layout for narrow terminals", "default": "false" }, { "flags": "--no-cost", "description": "Hide cost information in table and JSON output", "default": "false" }, { "flags": "--color", "description": "Enable colored output. FORCE_COLOR=1 has the same effect.", "default": "auto" }, { "flags": "--no-color", "description": "Disable colored output. NO_COLOR=1 has the same effect.", "default": "auto" }, { "flags": "--config <config>", "description": "Path to configuration file", "default": "auto-discovery" }, { "flags": "-h, --help", "description": "Display this help message" }, { "flags": "-v, --version", "description": "Display this version" } ], "last_options": [ { "flags": "--last <last>", "description": "Show only the most recent N periods of the report (1 is today, this week, or this month)" } ], "blocks_options": [ { "flags": "-a, --active", "description": "Show only active block with projections", "default": "false" }, { "flags": "-r, --recent", "description": "Show blocks from last 3 days (including active)", "default": "false" }, { "flags": "-t, --token-limit <token-limit>", "description": "Token limit for quota warnings (e.g., 500000 or \"max\")" }, { "flags": "-n, --session-length [session-length]", "description": "Session block duration in hours", "default": "5" } ], "codex_options": [ { "flags": "-j, --json", "description": "Output in JSON format", "default": "false" }, { "flags": "-s, --since <since>", "description": "Filter from date (YYYY-MM-DD or YYYYMMDD)" }, { "flags": "-u, --until <until>", "description": "Filter until date (inclusive)" }, { "flags": "-z, --timezone <timezone>", "description": "Timezone for date grouping (IANA)" }, { "flags": "-O, --offline", "description": "Use cached pricing data instead of fetching from LiteLLM", "default": "false" }, { "flags": "--no-offline", "description": "Negatable of -O, --offline" }, { "flags": "--speed [speed]", "description": "Cost speed tier: auto uses recorded settings, then Codex config.toml; use standard or fast to override", "default": "auto", "choices": ["auto", "standard", "fast"] }, { "flags": "--compact", "description": "Force compact table layout for narrow terminals", "default": "false" }, { "flags": "--no-cost", "description": "Hide cost information in table and JSON output", "default": "false" }, { "flags": "--color", "description": "Enable colored output. FORCE_COLOR=1 has the same effect.", "default": "auto" }, { "flags": "--no-color", "description": "Disable colored output. NO_COLOR=1 has the same effect.", "default": "auto" }, { "flags": "--config <config>", "description": "Path to configuration file", "default": "auto-discovery" }, { "flags": "-h, --help", "description": "Display this help message" }, { "flags": "-v, --version", "description": "Display this version" } ], "daily_options": [ { "flags": "-i, --instances", "description": "Show usage breakdown by project/instance", "default": "false" }, { "flags": "-p, --project <project>", "description": "Filter to specific project name" }, { "flags": "--project-aliases <project-aliases>", "description": "Comma-separated project aliases (e.g., 'ccusage=Usage Tracker,myproject=My Project')" } ], "pi_options": [ { "flags": "--pi-path <pi-path>", "description": "Path or comma-separated paths to pi-agent sessions directories" } ], "openclaw_options": [ { "flags": "--open-claw-path <open-claw-path>", "description": "Path or comma-separated paths to OpenClaw data directories (default: ~/.openclaw, ~/.clawdbot, ~/.moltbot, ~/.moldbot)" } ], "session_options": [ { "flags": "-i, --id <id>", "description": "Filter to specific session ID" } ], "shared_claude_options": [ { "flags": "-s, --since <since>", "description": "Filter from date (YYYYMMDD format)" }, { "flags": "-u, --until <until>", "description": "Filter until date (YYYYMMDD format)" }, { "flags": "-j, --json", "description": "Output in JSON format", "default": "false" }, { "flags": "-m, --mode [mode]", "description": "Cost calculation mode", "default": "auto", "choices": ["auto", "calculate", "display"] }, { "flags": "-d, --debug", "description": "Show pricing mismatch information for debugging", "default": "false" }, { "flags": "--debug-samples [debug-samples]", "description": "Number of sample discrepancies to show in debug output", "default": "5" }, { "flags": "-o, --order [order]", "description": "Sort order", "default": "asc", "choices": ["desc", "asc"] }, { "flags": "-b, --breakdown", "description": "Show per-model cost breakdown", "default": "false" }, { "flags": "-O, --offline", "description": "Use cached pricing data for Claude models instead of fetching from API", "default": "false" }, { "flags": "--no-offline", "description": "Negatable of -O, --offline" }, { "flags": "--single-thread", "description": "Disable parallel JSONL file loading", "default": "false" }, { "flags": "--color", "description": "Enable colored output. FORCE_COLOR=1 has the same effect.", "default": "auto" }, { "flags": "--no-color", "description": "Disable colored output. NO_COLOR=1 has the same effect.", "default": "auto" }, { "flags": "-z, --timezone <timezone>", "description": "Timezone for date grouping (e.g., UTC, America/New_York, Asia/Tokyo)", "default": "system timezone" }, { "flags": "--config <config>", "description": "Path to configuration file", "default": "auto-discovery" }, { "flags": "--compact", "description": "Force compact mode for narrow displays (better for screenshots)", "default": "false" }, { "flags": "-h, --help", "description": "Display this help message" }, { "flags": "-v, --version", "description": "Display this version" } ], "statusline_options": [ { "flags": "-O, --offline", "description": "Use cached pricing data for Claude models instead of fetching from API", "default": "true" }, { "flags": "--no-offline", "description": "Negatable of -O, --offline" }, { "flags": "-B, --visual-burn-rate [visual-burn-rate]", "description": "Controls the visualization of the burn rate status", "default": "off", "choices": ["off", "emoji", "text", "emoji-text"] }, { "flags": "--cost-source [cost-source]", "description": "Session cost source", "default": "auto", "choices": ["auto", "ccusage", "cc", "both"] }, { "flags": "--cache", "description": "Enable cache for status line output", "default": "true" }, { "flags": "--no-cache", "description": "Negatable of --cache" }, { "flags": "--refresh-interval [refresh-interval]", "description": "Refresh interval in seconds for cache expiry", "default": "1" }, { "flags": "--context-low-threshold [context-low-threshold]", "description": "Context usage percentage below which status is shown in green (0-100)", "default": "50" }, { "flags": "--context-medium-threshold [context-medium-threshold]", "description": "Context usage percentage below which status is shown in yellow (0-100)", "default": "80" }, { "flags": "-z, --timezone <timezone>", "description": "Timezone for date grouping (IANA)" }, { "flags": "--config <config>", "description": "Path to configuration file", "default": "auto-discovery" }, { "flags": "-d, --debug", "description": "Show pricing mismatch information for debugging", "default": "false" }, { "flags": "-h, --help", "description": "Display this help message" }, { "flags": "-v, --version", "description": "Display this version" } ], "weekly_options": [ { "flags": "-w, --start-of-week [start-of-week]", "description": "Start day of the week", "default": "sunday", "choices": ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"] } ]}