[DOCS] Commands docs still describe `/cost` and `/stats` as standalone commands after the `/usage` merge
Documentation Type
Incorrect/outdated documentation
Documentation Location
https://code.claude.com/docs/en/commands
Section/Topic
The commands table entries for /cost, /stats, and /usage, plus the /cost guidance in the cost tracking docs.
Current Documentation
The commands reference currently says:
|/cost| Show token usage statistics. See cost tracking guide for subscription-specific details | |/stats| Visualize daily usage, session history, streaks, and model preferences | |/usage| Show plan usage limits and rate limit status |
The cost tracking page also says:
The/costcommand shows API token usage and is intended for API users. Claude Max and Pro subscribers have usage included in their subscription, so/costdata isn't relevant for billing purposes. Subscribers can use/statsto view usage patterns.
What's Wrong or Missing?
Changelog v2.1.118 says: Merged /cost and /stats into /usage — both remain as typing shortcuts that open the relevant tab.
The docs still present /cost, /stats, and /usage as three separate commands with separate purposes. They do not explain that /usage is now the unified command surface, and that typing /cost or /stats just opens the corresponding tab inside /usage.
That leaves the command reference and cost guidance outdated for users trying to understand which command is primary and what behavior to expect after v2.1.118.
Suggested Improvement
Update the commands reference to make /usage the primary documented command and describe /cost and /stats as typing shortcuts that open the Cost and Stats tabs within /usage.
Update the cost tracking page to match that model. For example, the subscriber note could explain that subscribers can open usage views through /usage, and that /stats remains a shortcut to the Stats tab rather than a separate standalone command.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 35, 83-94 | The commands table still documents /cost, /stats, and /usage as separate commands |
| https://code.claude.com/docs/en/costs | 17-23 | The cost tracking page still treats /cost and /stats as separate command surfaces |
Total scope: 2 pages affected
Source: Changelog v2.1.118
Exact changelog entry: Merged /cost and /stats into /usage — both remain as typing shortcuts that open the relevant tab
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗