docs(cli): document the /team slash command - #684
Merged
Conversation
/team is a GA, unflagged Warp Agent CLI slash command (StaticCommand TEAM, SlashCommandSurfaces::TuiOnly, Availability::ALWAYS in app/src/search/slash_command_menu/static_commands/commands.rs) that was missing from the CLI reference's slash command table, which presents itself as the complete list. Adds the table row plus one sentence describing the behavior that differs from the desktop app: the CLI re-scopes the current session in place, while the desktop app opens a new window for the chosen team. 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 |
hongyi-chen
added a commit
that referenced
this pull request
Sep 4, 2026
…erence Exhaustive drift-watch re-run for v0.2026.09.02.08.27.stable_01. Every standing finding and every surface/changelog change in this release range was already triaged on this PR; re-running the audit against this branch leaves only the 23 known terminology false positives. The one new gap: /team, a GA and ungated TUI-only slash command, was absent from the slash command table on agents/cli/reference.mdx. Two compounding reasons hid it from the audit -- the `-> internal` map entry (correct for the GUI slash-commands page, wrong for the CLI table) and the repo-wide slash check documented as a known limitation in SKILL.md. Remaps /team to the CLI reference and records four verdicts: the /team pass, the both-surface scoped slash re-verification, the 11 sibling TUI-only entries whose `internal` sentinel overstates "no public docs" (deferred, no audit-outcome change), and the weak-coverage re-run. Snapshot regeneration is a no-op on this branch; it was already current. Docs change ships separately in #684. Co-Authored-By: Warp <agent@warp.dev>
3 tasks
moirahuang
approved these changes
Sep 4, 2026
warp-factories Bot
added a commit
that referenced
this pull request
Sep 5, 2026
…sing_docs bookkeeping for v0.2026.08.26–v0.2026.09.02) (#657) * docs: document completion and custom endpoint settings keys Add warp_completions_enabled, native_shell_completions_enabled, and agents.custom_endpoints to the all-settings reference for the v0.2026.08.26.17.59.stable_01 missing_docs drift-watch triage. Fold in surface-map internal factory routes, changelog verdicts, release marker, and snapshot regen. Co-Authored-By: Oz <oz-agent@warp.dev> * chore(missing_docs): record exhaustive-pass verdicts and fix KittyImages map target Second, exhaustive pass over the same release. Adds ledger rows for the surface-scoped slash command finding (shipped as its own feature PR), the 81 --weak-coverage findings, and an itemized re-verification of the 23 potentially_stale_docs findings that supersedes the earlier bulk row. Retargets the KittyImages map entry: it pointed at full-screen-apps.mdx, which documents the Kitty keyboard protocol, but the Kitty image protocol is documented on files-and-links.mdx. Co-Authored-By: Warp <agent@warp.dev> * chore(missing_docs): record LrcActivitySignal deferral and refresh snapshot Drift-watch re-run after v0.2026.08.26.17.59.stable_01 bookkeeping: defer the new dogfood flag and regenerate the surface snapshot so the next --diff run is clean of medium findings. * chore(missing_docs): gate completion settings and map factory cost routes Address docs#657 review: state that warp/native completion toggles only take effect under the Native shell completions Preview. Map the four factory /costs/* API routes as internal, prune dead /metrics/* map entries, record the dogfood→preview NativeShellCompletions deferral, and refresh the surface snapshot. * chore(missing_docs): map factory-inbox and learning routes Extend docs#657 bookkeeping for the v0.2026.08.26 release re-run: map GET/POST /factory-inbox* and POST /factory/{uid}/learning as internal (Gate 0 — unreleased Factory REST), record ledger verdicts, refresh last_release marker timestamp and surface snapshot. * chore(missing_docs): defer HistorySearchRankingV2 preview flag Record Gate 0 deferral for the new preview history-search ranking flag, add it to the surface-map ignore list, and refresh the surface snapshot. * chore(missing_docs): defer ShellWidgetHandoff and map factory Linear handoff route Exhaustive drift-watch re-run for v0.2026.08.26.17.59.stable_01. - Ignore the new ShellWidgetHandoff preview flag (Gate 0: not GA). - Map POST /factory/{uid}/integrations/linear/handoff -> internal (Gate 0: unreleased /factory namespace). - Record this run's verdicts, including the corrected staleness verdict for the three live "Warp AI credits" usages. - Refresh surface_snapshot.json. Co-Authored-By: Warp <agent@warp.dev> * chore(missing_docs): bookkeeping for v0.2026.09.02.08.27.stable_01 Drift-watch triage for the 2026.09.02 stable release. No new feature docs — all 09.02 changelog and oz_updates items failed the worthiness gates or were already covered. Map internal screenshot download and factory source/validate routes, prune dead compose-from-run entry, allowlist ssh-legacy, append ledger verdicts, advance the release marker, and regenerate the surface snapshot. * chore(missing_docs): record /team verdict and remap it to the CLI reference Exhaustive drift-watch re-run for v0.2026.09.02.08.27.stable_01. Every standing finding and every surface/changelog change in this release range was already triaged on this PR; re-running the audit against this branch leaves only the 23 known terminology false positives. The one new gap: /team, a GA and ungated TUI-only slash command, was absent from the slash command table on agents/cli/reference.mdx. Two compounding reasons hid it from the audit -- the `-> internal` map entry (correct for the GUI slash-commands page, wrong for the CLI table) and the repo-wide slash check documented as a known limitation in SKILL.md. Remaps /team to the CLI reference and records four verdicts: the /team pass, the both-surface scoped slash re-verification, the 11 sibling TUI-only entries whose `internal` sentinel overstates "no public docs" (deferred, no audit-outcome change), and the weak-coverage re-run. Snapshot regeneration is a no-op on this branch; it was already current. Docs change ships separately in #684. Co-Authored-By: Warp <agent@warp.dev> --------- Co-authored-by: warp-factories[bot] <243557089+warp-factories[bot]@users.noreply.github.com> Co-authored-by: Oz <oz-agent@warp.dev> Co-authored-by: Warp <agent@warp.dev> Co-authored-by: hongyi-chen <hongyigma@gmail.com> Co-authored-by: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
hongyi-chen
marked this pull request as ready for review
September 8, 2026 05:18
Contributor
|
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 |
![warp-for-oss[bot]](https://avatars.githubusercontent.com/in/3450139?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Overview
This PR documents the /team slash command in src/content/docs/agents/cli/reference.mdx. The command description itself matches the available TUI source behavior: /team opens a searchable team switcher, switches the active team in the current session, and the statusline team label opens the same menu. No security issues were found, and no approved spec context was available.
Concerns
- 🚨 [CRITICAL] The PR appears to be agent-authored (
missing-docs/cli-team-slash-commandand a body that cites themissing_docsaudit), but the attached PR body is missing the required## Documentation risksection. Agent-authored docs PRs must carry the v1 quality contract metadata before review can pass. Because the risk section is absent, the structural checker returns immediately; add both the required## Documentation riskmetadata and the## Unverified claimssection before requesting review again.
Verdict
Found: 1 critical, 0 important, 1 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
Co-authored-by: warp-for-oss[bot] <277970191+warp-for-oss[bot]@users.noreply.github.com>
hongyi-chen
enabled auto-merge (squash)
September 8, 2026 05:29
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
Co-Authored-By: Warp <agent@warp.dev>
github-actions
Bot
dismissed
their stale review
September 9, 2026 04:57
Superseded by the current Agent docs review check.
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
2 participants
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
/teamswitches the active team from inside the Warp Agent CLI. It opens a searchable list of the teams you belong to, marks the active one, and re-scopes the current session in place. The Warp app has no in-place equivalent: its title-bar pill opens a new window for the chosen team. The command is GA and ungated —TuiOnly,Availability::ALWAYS, no feature flag.Why this was missing
The "Slash commands" table in
agents/cli/reference.mdxpresents itself as the complete list of CLI slash commands, and/teamwas the only GA, unflagged TUI-capable command absent from it.The
missing_docsaudit could not see the gap, for two compounding reasons:/teamis mapped-> internalin the surface map. That entry is correct for the GUI slash-commands page — the command does not exist in the desktop app — but the CLI reference maintains its own table, whichinternalalso suppresses.SKILL.md): a command counts as covered when any page mentions it. This is the same blind spot that previously let/usageand/set-tab-colorship undocumented.Caught by re-running the surface-scoped check that prior runs used to work around that limitation.
Worthiness verdict
Gate 1 — update an existing page. The knob is the nameable command
/teamitself, matching the/continue-locallyworked example in.agents/references/docs-worthiness-criteria.md("a nameable command, which is a knob, so Gate 1 carries it"). Gate 4 does not apply: the product surfaces the command in the slash menu and in the statusline team label, which opens the same list on click.No content design plan: this adds a missing entry to an existing reference table, which
.agents/references/content-design-plan.mdlists under "When a plan can be skipped."Changes
/teamrow to the slash commands table, in alphabetical position between/statuslineand/theme./statusand/usageexplanations, covering the filter-and-Enterflow, the in-place re-scoping that differs from the desktop app, and the statusline affordance.Validation
npm run build— passes (383 pages, 381 markdown docs generated).style_lint --changed— oneTONE-META-OPENERhit at line 252 ("This section covers common issues..."), pre-existing in the Troubleshooting section and untouched by this diff. Left for astyle_lintsweep rather than widening scope.Deferred findings from this run
The rest of the audit was already in sync. Full triage lives in the companion bookkeeping PR #657; deferrals worth naming here:
/team's surface-map entry moves frominternalto this page in docs: document completion, custom endpoint, and /team surfaces (+ missing_docs bookkeeping for v0.2026.08.26–v0.2026.09.02) #657. Eleven sibling TUI-only commands (/exit,/status,/api-keys,/vim-mode,/theme,/voice,/clear,/logout,/statusline,/reset-statusline,/natural-language-detection) are still mapped-> internaleven though they are documented in this same table. Suppression behavior is identical either way, so this is a map-accuracy nit rather than a docs gap; deferred to avoid churning a PR already under review.audit_docs.py. Until it is surface-scoped,doc_coveredcannot be read as "documented in the right place."ShellWidgetHandoff,HistorySearchRankingV2) andagents.warp_agent.other.usage_display_unit(dogfood, gated byPricingTransparency) fail Gate 0 and re-surface on promotion./factory*and screenshot-download API routes arex-internal: truein warp-server's canonical spec, so the publish filter strips them from the released OpenAPI. Not hand-documentable; re-check when the Factory REST API is published.potentially_stale_docsfindings are terminology-only false positives, itemized and rejected in the ledger. The unresolvedai creditsrule conflict is still flagged there for a human docs owner.Unverified claims
None. Every claim in the added table row and paragraph was verified against
warpdotdev/warp@6db7fb734885, in the files listed under "Documentation risk" below. TheTEAMStaticCommandincommands.rscarries the name, description,SlashCommandSurfaces::TuiOnly, andAvailability::ALWAYSwith nofeature_flag, and its doc comment states the in-place re-scope versus the Warp app's new-window switch.TuiTeamMenuModelinteam_menu.rsimplements the searchable list, the(active)suffix on the current team, and the substring filter. TheToggleTeamMenudispatch instatusline.rsmakes the statusline team label open that same menu.Documentation risk
Risk: engineering-review-required
Rationale: Documents a CLI slash command and its runtime behavior, a technical-claim category outside the low-risk allowlist.
Source files consulted: warp:app/src/search/slash_command_menu/static_commands/commands.rs@6db7fb734885, warp:crates/warp_tui/src/team_menu.rs@6db7fb734885, warp:crates/warp_tui/src/terminal_session_view/statusline.rs@6db7fb734885
Requested engineering reviewers: moirahuang
Engineering review status: approved
Docs override: none
/cc @moirahuang