docs: complete the built-in Slash Commands table - #658
Draft
hongyi-chen wants to merge 1 commit into
Draft
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.
|
Collaborator
Author
|
This PR was generated with Warp. Comment |
moirahuang
approved these changes
Aug 28, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.


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