Skip to content

docs: complete the built-in Slash Commands table - #658

Draft
hongyi-chen wants to merge 1 commit into
mainfrom
missing-docs/gui-slash-command-table-completeness
Draft

docs: complete the built-in Slash Commands table#658
hongyi-chen wants to merge 1 commit into
mainfrom
missing-docs/gui-slash-command-table-completeness

Conversation

@hongyi-chen

Copy link
Copy Markdown
Collaborator

What this feature does

Four GA Slash Commands were missing from the built-in Slash Commands table on agents/capabilities/slash-commands.mdx, a page that presents that table as the complete list ("Warp currently supports the following built-in Slash Commands"). Three of them (/continue-locally, /handoff, /remote-control) are documented on their own feature pages but absent from the reference table. /set-tab-color was undocumented anywhere in the docs.

Summary

missing_docs drift-watch for stable v0.2026.08.26.17.59.stable_01, exhaustive pass.

The audit's slash command check reported 0 findings because, as the skill documents, that check is repo-wide rather than surface-scoped: a command counts as covered when any page mentions it. This run re-ran the check scoped by the registry's own SlashCommandSurfaces field (GuiOnly / TuiOnly / GuiAndTui), which is the same blind spot that previously let /usage ship undocumented for CLI users.

Scoped results:

  • Warp Agent CLI — all 32 TUI-capable commands are covered under agents/cli/. Clean.
  • GUI — 4 GA commands absent from the reference table. /docker-sandbox is also absent but is deliberately mapped -> internal in the surface map, so it stays out.

Changes

src/content/docs/agents/capabilities/slash-commands.mdx

Four rows added in alphabetical position:

  • /continue-locally — fork the current cloud agent conversation into a local Warp session
  • /handoff — hand the current local conversation off to a cloud agent (marked *, since cloud agent runs consume credits)
  • /remote-control — publish the current third-party CLI agent session to the cloud
  • /set-tab-color — set the current tab's color

src/content/docs/terminal/windows/tabs.mdx

One paragraph under Tab colors > Set a tab's color, giving /set-tab-color as an alternative to the right-click flow, alongside the existing right-click and cycle-color entry points.

Content design plan

No plan required. Per .agents/references/content-design-plan.md → "When a plan can be skipped", this is adding a missing entry to an existing reference table or list where the surrounding page already establishes the reader and the format. The tabs.mdx addition is a second entry point for a flow the section already documents, not a new concept.

Worthiness verdicts

All four pass Gate 1 (configurable — a nameable command is a knob) and resolve to update an existing page, the preferred outcome. /continue-locally is in fact the worked example in .agents/references/docs-worthiness-criteria.md making exactly this point: it fails Gate 4's second condition because the menu surfaces it, but Gate 1 carries it anyway.

Gate 0 verified against app/src/search/slash_command_menu/static_commands/commands.rs: all four are in the public warpdotdev/warp repo and carry no feature_flag, so all are GA.

Unverified claims

None. Command names, descriptions, surfaces, and argument shapes are verified against app/src/search/slash_command_menu/static_commands/commands.rs. The /set-tab-color color list comes from TAB_COLOR_OPTIONS in app/src/ui_components/color_dot.rs (red, green, yellow, blue, magenta, cyan) plus the none sentinel in SET_TAB_COLOR_HINT.

Deferred findings

Recorded in the bookkeeping added to #657. Nothing in this run's exhaustive sweep is dropped silently:

  • --weak-coverage (81 low findings) — no docs. Every one is a mapped, curated surface-map entry whose page simply doesn't contain a phrase derived from the internal flag name. Spot-verified against code and docs: FullScreenZenModeworkspace_decoration_visibility is documented; SuggestedRulesrule_suggestions_enabled is documented and rules.mdx describes the behavior; SharedWithMe → warp-drive sharing is documented; tab flags → tabs.mdx covers groups, dragging, and colors. One map-target nit fixed in the bookkeeping: KittyImages pointed at full-screen-apps.mdx, but the Kitty image protocol is documented on files-and-links.mdx.
  • 23 potentially_stale_docs — no docs. Verified line by line rather than dismissed in bulk. "AI credits" is the deliberate name of the inference bucket, contrasted throughout with compute credits and platform credits; "Warp AI" hits are verbatim telemetry event names in privacy.mdx plus one historical FAQ; "Warp Terminal" hits are the distinguishing usage the style guide allows. Pure wording questions belong to style_lint.
  • 2 /factory API routes, 3 new settings, usage_display_unit, NativeShellCompletions, and the 15 changelog items — already triaged by the earlier run for this same release; verdicts re-verified and left standing in docs: document completion and custom endpoint settings keys (+ missing_docs bookkeeping for v0.2026.08.26) #657.
  • /docker-sandbox — no docs; already mapped -> internal.

/cc @moirahuang @vkodithala

Co-Authored-By: Warp agent@warp.dev

The Slash Commands page presents its table as the full list of built-in
commands, but four GA commands from the static registry were absent:
/continue-locally, /handoff, /remote-control, and /set-tab-color.

/set-tab-color was undocumented anywhere, so also add it to the Tab
colors section of the tabs page alongside the right-click flow and the
cycle-color action.

Co-Authored-By: Warp <agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label Aug 28, 2026
@vercel

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

Request Review

Copy link
Copy Markdown
Collaborator Author

This PR was generated with Warp.

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

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.

3 participants