Skip to content

docs(cli): document the new Warp Agent CLI slash commands - #493

Draft
hongyi-chen wants to merge 1 commit into
mainfrom
docs/cli-slash-commands
Draft

docs(cli): document the new Warp Agent CLI slash commands#493
hongyi-chen wants to merge 1 commit into
mainfrom
docs/cli-slash-commands

Conversation

@hongyi-chen

Copy link
Copy Markdown
Collaborator

Documents the Warp Agent CLI slash commands that the missing_docs drift-watch audit flagged as new-but-undocumented, plus the ones already in the registry that the CLI reference table was missing.

What changed

cli/reference.mdx — added the missing rows to the slash command table so it matches app/src/search/slash_command_menu/static_commands/commands.rs:

  • /connect-grok — connect an X Premium or SuperGrok subscription (new, flagged by the audit)
  • /manage-billing — open the team billing page (new, flagged by the audit)
  • /upgrade — open the Warp upgrade page (new, flagged by the audit)
  • /fork, /reset-statusline, /status, /vim-mode — already shipped and TUI-registered, but absent from a table that claims to list every slash command

cli/index.mdx — new "Checking your account, plan, and billing" section covering /status, /upgrade, and /manage-billing. /manage-billing is documented as admin-only because the CLI only registers it when manage_billing_url resolves for the signed-in user (app/src/terminal/input/slash_commands/data_source/tui.rs).

cli/models-and-usage.mdx and agents/inference/grok-subscription.mdx/connect-grok documented as the CLI shortcut into the same xAI sign-in that /api-keys exposes.

cli/input-and-shell-commands.mdx — short "Vim mode" subsection for /vim-mode, which was previously only referenced indirectly through the statusline indicator.

cli/configuration.mdx/reset-statusline noted alongside /statusline.

Verification

  • All three flagged slash commands are ungated (Availability::ALWAYS / AI_ENABLED, no feature flag) and SlashCommandSurfaces::TuiOnly, so they are GA and CLI-only.
  • Behavior confirmed against crates/warp_tui/src/terminal_session_view.rs (execute_tui_slash_command) and terminal_session_view/status_menu.rs.
  • npm run build passes (364 pages).
  • Internal link check passes (3457 links, 0 broken).
  • Re-running the audit drops undocumented_slash_commands from 3 to 0.

Deferred findings from this audit run

Nothing else in this run needs a doc page, but these were triaged and deliberately left for other owners:

  • 3 public API endpoints missing from developers/agent-api-openapi.yaml (GET /agent/artifacts/{artifactUid}/download, GET /agent/run-by-external-reference, POST /agent/runs/{runId}/scores). They are present and non-x-internal in warp-server's canonical spec, so they belong in the published subset — but the regeneration is a wholesale rewrite that would also publish research-preview Agent Memory schemas (AgentMemoryCreateConfig, AgentAutoMemoryResponse, MemoryStoreAttachmentResponse, …) that are transitively referenced from CreateAgentRequest/AgentResponse. Per the skill's public/private guardrail this is deferred to a dedicated sync-openapi-spec run once that exposure is settled. Details are in the companion bookkeeping PR.
  • 30 low-severity terminology findings, owned by style_lint. Details in the companion bookkeeping PR.

Surface map and snapshot updates for this run ship in the companion audit-bookkeeping PR.

Conversation: https://staging.warp.dev/conversation/52a9f9f7-2e0a-43ae-82c4-84a04c9d4eb1
Run: https://oz.staging.warp.dev/runs/019fdd2a-edce-719d-9dc1-678ca78ec7e0

This PR was generated with Oz.

Adds /connect-grok, /manage-billing, and /upgrade, which the docs audit
flagged as new but undocumented slash commands, and fills the remaining
gaps in the CLI slash command table (/fork, /reset-statusline, /status,
/vim-mode) so it matches the registry in static_commands/commands.rs.

Co-Authored-By: Warp Agent <agent@warp.dev>
@hongyi-chen hongyi-chen added the documentation Improvements or additions to documentation label Aug 7, 2026
@cla-bot cla-bot Bot added the cla-signed label Aug 7, 2026
@vercel

vercel Bot commented Aug 7, 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 7, 2026 5:16pm

Request Review

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

Labels

cla-signed documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant