Skip to content

Document /usage in the Warp Agent CLI - #623

Open
rachaelrenk wants to merge 2 commits into
mainfrom
missing-docs/cli-usage-slash-command
Open

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

Conversation

@rachaelrenk

@rachaelrenk rachaelrenk commented Aug 25, 2026

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)

@rachaelrenk @warp-agent
Document /usage in the Warp Agent CLI
239d3eb 
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
@rachaelrenk Warp Factories

rachaelrenk commented Aug 25, 2026

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 •
edited
Loading

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 7:41pm

Request Review

@warp-factories

warp-factories Bot commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

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

@warp-agent-staging

warp-agent-staging Bot commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

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

@rachaelrenk
rachaelrenk marked this pull request as ready for review August 25, 2026 19:38
@warp-for-oss

warp-for-oss Bot commented Aug 25, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

@rachaelrenk

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

warp-for-oss[bot]
warp-for-oss Bot reviewed Aug 25, 2026
View reviewed changes

@warp-for-oss warp-for-oss Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overview

This PR documents the Warp Agent CLI /usage slash command in the existing CLI models-and-usage and reference pages. The additions are concise, placed with the related /cost and account status documentation, and use valid internal anchors.

Concerns

  • No blocking concerns found.
  • No security findings; the diff only changes documentation prose.
  • No approved spec context was available for implementation drift checks.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

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

Reviewers

@warp-for-oss warp-for-oss[bot] warp-for-oss[bot] left review comments
@moirahuang moirahuang Awaiting requested review from moirahuang

At least 1 approving review is required to merge this pull request.

Assignees

No one assigned

Labels

cla-signed

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@rachaelrenk