Skip to content

Document /usage in the Warp Agent CLI - #623

Draft
rachaelrenk wants to merge 1 commit into
mainfrom
missing-docs/cli-usage-slash-command
Draft

Document /usage in the Warp Agent CLI#623
rachaelrenk wants to merge 1 commit into
mainfrom
missing-docs/cli-usage-slash-command

Conversation

@rachaelrenk

Copy link
Copy Markdown
Contributor

Summary

Documents the Warp Agent CLI /usage slash command shipped in v0.2026.08.19 (#14968). The GUI slash-commands table already listed it; the CLI models/usage page and CLI reference did not.

Changes

src/content/docs/agents/cli/models-and-usage.mdx

  • Expand Usage and cost to three levels and document account-level /usage

src/content/docs/agents/cli/reference.mdx

  • Add /usage to the slash command table
  • Add a short panel description with a link to models and usage

Content design plan

  • Reader and job: A developer in the Warp Agent CLI who needs plan and credit usage without leaving the session.
  • Gap today: CLI docs covered /cost and statusline conversation totals but not the account-level /usage panel.
  • Change: One bullet under Usage and cost plus a reference-table row and one-sentence description. Excludes plan-limit matrix detail owned by billing pages.

Unverified claims

None — /usage name, description ("View account and credit usage"), and GuiAndTui surface verified against app/src/search/slash_command_menu/static_commands/commands.rs and crates/warp_tui/src/terminal_session_view/usage_menu.rs. Panel contents (plan, credits, billing links) verified against the usage menu renderer.

Docs-worthiness

  • Verdict: yes
  • Gate: Gate 1 (concrete knob: /usage)
  • Outcome: update existing pages (not a new page)
  • Source: changelog 2026.08.19 / warp#14968

Deferred findings from this drift-watch run

Recorded in the companion bookkeeping PR:

  • Warp Factories EA launch — major launch / already documented
  • MCP sandbox rebuild fix — bug fix, no docs
  • CtrlCCancelsThirdPartyHarness GA — internal status synthesis, ignore
  • OpenWarpNewSettingsModes removed — prune ignore entry
  • POST /factory/{uid}/runs and POST /factory/automations/{id}/run — Gate 0 deferred (-> internal until public OpenAPI publish)

Add the account-level /usage slash command to the CLI models-and-usage
page and the CLI reference slash-command table.

Co-Authored-By: Warp <agent@warp.dev>
@rachaelrenk
rachaelrenk requested a review from moirahuang August 25, 2026 00:58

Copy link
Copy Markdown
Contributor Author

This PR was generated with Warp.

Comment @warp-agent on this PR to send it follow-up work.

View run View conversation

@cla-bot cla-bot Bot added the cla-signed label Aug 25, 2026
@vercel

vercel Bot commented Aug 25, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 25, 2026 1:00am

Request Review

@warp-factories

Copy link
Copy Markdown
Contributor

Your GitHub account is not connected to Warp. Connect it here.

@warp-agent-staging

Copy link
Copy Markdown
Contributor

Your GitHub account is not connected to Warp. Connect it here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant