docs: complete the built-in Slash Commands table - #658
Conversation
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>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
This PR was generated with Warp. Comment |
|
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 Powered by Oz |
There was a problem hiding this comment.
Overview
This PR updates the Slash Commands reference table with four missing built-in commands and adds /set-tab-color as another tab color entry point. The command coverage and internal links match existing docs; no approved spec context was provided, and the security pass found no code or configuration surface.
Concerns
tabs.mdxadds an em dash in a procedural instruction, which violates the docs style guide's rule against em dashes in procedural or instructional text.- No security findings.
Verdict
Found: 0 critical, 1 important, 0 suggestions
Request changes
Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).
Powered by Oz
|
|
||
| To remove a color, right-click the tab and click the same color again, or pick the default (no color) option. | ||
|
|
||
| You can also set the color without leaving the input. Run the [`/set-tab-color`](/agents/capabilities/slash-commands/) Slash Command with the color you want — `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, or `none` to clear it. For example, `/set-tab-color blue`. |
There was a problem hiding this comment.
| You can also set the color without leaving the input. Run the [`/set-tab-color`](/agents/capabilities/slash-commands/) Slash Command with the color you want — `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, or `none` to clear it. For example, `/set-tab-color blue`. | |
| You can also set the color without leaving the input. Run the [`/set-tab-color`](/agents/capabilities/slash-commands/) Slash Command with the color you want: `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, or `none` to clear it. For example, `/set-tab-color blue`. |


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-colorwas undocumented anywhere in the docs.Summary
missing_docsdrift-watch for stablev0.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
SlashCommandSurfacesfield (GuiOnly/TuiOnly/GuiAndTui), which is the same blind spot that previously let/usageship undocumented for CLI users.Scoped results:
agents/cli/. Clean./docker-sandboxis also absent but is deliberately mapped-> internalin 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 colorsrc/content/docs/terminal/windows/tabs.mdx
One paragraph under Tab colors > Set a tab's color, giving
/set-tab-coloras 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. Thetabs.mdxaddition 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-locallyis in fact the worked example in.agents/references/docs-worthiness-criteria.mdmaking 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 publicwarpdotdev/warprepo and carry nofeature_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-colorcolor list comes fromTAB_COLOR_OPTIONSinapp/src/ui_components/color_dot.rs(red, green, yellow, blue, magenta, cyan) plus thenonesentinel inSET_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:FullScreenZenMode→workspace_decoration_visibilityis documented;SuggestedRules→rule_suggestions_enabledis documented andrules.mdxdescribes the behavior;SharedWithMe→ warp-drive sharing is documented; tab flags →tabs.mdxcovers groups, dragging, and colors. One map-target nit fixed in the bookkeeping:KittyImagespointed atfull-screen-apps.mdx, but the Kitty image protocol is documented onfiles-and-links.mdx.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 inprivacy.mdxplus one historical FAQ; "Warp Terminal" hits are the distinguishing usage the style guide allows. Pure wording questions belong tostyle_lint./factoryAPI 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