warpdotdev · hongyi-chen · Aug 7, 2026
diff --git a/.agents/skills/missing_docs/references/feature_surface_map.md b/.agents/skills/missing_docs/references/feature_surface_map.md
@@ -323,6 +323,15 @@ POST /oauth/token -> internal
 GET /oauth/jwks.json -> internal
 GET /.well-known/openid-configuration -> internal
 
+# Consent endpoints backing the web consent screen for third-party OAuth clients
+# (router/handlers/public_api/oauth2.go). GET /consent/info maps a client_id to
+# the display name shown on the screen, and POST /consent records the grant that
+# GET /oauth/authorize redirects to. They are browser-facing plumbing for the
+# authorize flow above, absent from warp-server's canonical public spec, so they
+# are not a documentable public API surface.
+POST /oauth/consent -> internal
+GET /oauth/consent/info -> internal
+
 # RFC 8414 / RFC 9728 OAuth discovery documents that MCP clients fetch
 # automatically before authenticating against the hosted Factory MCP endpoint
 # (router/handlers/public_api/oauth2.go, registered only when the dogfood-only
@@ -448,43 +457,44 @@ GET /memory_stores/{uid}/memories/{memoryUid}/versions -> gated:AIMemories
 # slash-commands page content; add entries here only for exceptions.
 # Gated by the dogfood-only LocalDockerSandbox flag — not user-facing yet.
 /docker-sandbox -> internal
-# Warp Agent CLI-only (crates/warp_tui) slash commands — added only when the
-# settings mode is the Warp Agent CLI (see static_commands/commands.rs). They
-# aren't present in the GUI desktop app, so they aren't documented on the public
-# slash-commands page. Consistent with the general.autoupdate_enabled Warp Agent
-# CLI-only setting mapped to `internal` above.
-/exit -> internal
-/view-logs -> internal
-/auto-approve -> internal
-/logout -> internal
-# The paired /enable- and /disable-natural-language-detection commands were
-# replaced by a single toggle, /natural-language-detection. Like the other Warp
-# Agent CLI-only commands above, it isn't in the GUI, so it stays internal.
-/natural-language-detection -> internal
-# TUI-only voice input command (Warp Agent CLI surface). The /version command was
-# removed from code; its entry has been pruned.
-/voice -> internal
-# More Warp Agent CLI-only (SlashCommandSurfaces::TuiOnly in static_commands/
-# commands.rs) commands. None are present in the GUI desktop app, so they aren't
-# documented on the public slash-commands page:
+# Warp Agent CLI-only (SlashCommandSurfaces::TuiOnly in static_commands/
+# commands.rs) slash commands — added only when the settings mode is the Warp
+# Agent CLI. They aren't present in the GUI desktop app, so they aren't on the
+# public slash-commands page; they are documented in the Warp Agent CLI slash
+# command reference instead:
+# - /exit: exit the CLI
+# - /view-logs: bundle logs into a zip archive
+# - /auto-approve: toggle auto-approve for agent actions
+# - /logout: log out of Warp
+# - /natural-language-detection: single toggle that replaced the removed
+#   /enable- and /disable-natural-language-detection pair
+# - /voice: start voice input (the /version command was removed from code; its
+#   entry has been pruned)
 # - /status: show session and account status
 # - /clear: clear the transcript and start a new conversation
-# - /statusline: configure the Warp Agent CLI statusline (agents.statusline, internal)
-# - /reset-statusline: restore the statusline to its default items and ordering
+# - /statusline and /reset-statusline: configure or reset the CLI statusline
 # - /api-keys: view and manage model-provider API keys. It replaced the removed
 #   /add-api-key and /clear-provider-api-key pair, whose entries were pruned.
-# - /vim-mode: toggle Vim keybindings in the Warp Agent CLI input
-/status -> internal
-/clear -> internal
-/statusline -> internal
-/reset-statusline -> internal
-/api-keys -> internal
-/vim-mode -> internal
-# TUI-only color-theme picker (Warp Agent CLI surface, SlashCommandSurfaces::TuiOnly
-# in static_commands/commands.rs). It sets the Warp Agent CLI theme
-# (appearance.theme, mapped internal below) and isn't present in the GUI, so it
-# stays internal like the other Warp Agent CLI-only commands.
-/theme -> internal
+# - /connect-grok: connect an X Premium or SuperGrok subscription
+# - /manage-billing and /upgrade: open the team billing and upgrade pages
+# - /vim-mode: toggle Vim keybindings in the CLI input
+# - /theme: set the CLI color theme (appearance.theme, mapped below)
+/exit -> src/content/docs/cli/reference.mdx
+/view-logs -> src/content/docs/cli/reference.mdx
+/auto-approve -> src/content/docs/cli/reference.mdx
+/logout -> src/content/docs/cli/reference.mdx
+/natural-language-detection -> src/content/docs/cli/reference.mdx
+/voice -> src/content/docs/cli/reference.mdx
+/status -> src/content/docs/cli/reference.mdx
+/clear -> src/content/docs/cli/reference.mdx
+/statusline -> src/content/docs/cli/reference.mdx
+/reset-statusline -> src/content/docs/cli/reference.mdx
+/api-keys -> src/content/docs/cli/reference.mdx
+/connect-grok -> src/content/docs/cli/reference.mdx
+/manage-billing -> src/content/docs/cli/reference.mdx
+/upgrade -> src/content/docs/cli/reference.mdx
+/vim-mode -> src/content/docs/cli/reference.mdx
+/theme -> src/content/docs/cli/reference.mdx
 
 ## Settings -> doc pages
 
@@ -498,42 +508,45 @@ GET /memory_stores/{uid}/memories/{memoryUid}/versions -> gated:AIMemories
 warpify.ssh.ssh_tmux_deprecation_notice_pending -> internal
 
 # Warp Agent CLI-only (crates/warp_tui) background auto-updater toggle (surface:
-# Warp Agent CLI). It isn't present in the GUI settings UI, so it isn't
-# documented in the all-settings reference.
-general.autoupdate_enabled -> internal
+# Warp Agent CLI). It isn't present in the GUI settings UI, so instead of the
+# all-settings reference it is documented with the CLI's update behavior.
+general.autoupdate_enabled -> src/content/docs/cli/index.mdx
 
 # Warp Agent CLI-only (crates/warp_tui) statusline configuration (surface:
 # SettingSurfaces::TUI in app/src/settings/ai.rs; controls the order and
 # visibility of the Warp Agent CLI bottom statusline items). It isn't present in
-# the GUI settings UI, so it isn't documented in the all-settings reference.
-# Paired with the /statusline Warp Agent CLI slash command mapped internal above.
-agents.statusline -> internal
+# the GUI settings UI, so it is documented on the CLI configuration page rather
+# than the all-settings reference, alongside the /statusline and
+# /reset-statusline slash commands.
+agents.statusline -> src/content/docs/cli/configuration.mdx
 
 # Warp Agent CLI-only (crates/warp_tui) color theme (surface: Warp Agent CLI,
 # SettingSurfaces::TUI in tui_theme.rs; "auto|light|dark" matching the host
-# terminal background). It isn't present in the GUI settings UI, so it isn't
-# documented in the all-settings reference. The GUI theme setting is the separate
-# appearance.themes.theme, which is documented. Paired with the /theme Warp Agent
-# CLI slash command mapped internal above.
-appearance.theme -> internal
+# terminal background). It isn't present in the GUI settings UI, so it is
+# documented on the CLI configuration page rather than the all-settings
+# reference. The GUI theme setting is the separate appearance.themes.theme.
+appearance.theme -> src/content/docs/cli/configuration.mdx
 
 # Warp Agent CLI-only (crates/warp_tui) zero-state animation knobs (surface: Warp
 # Agent CLI, SettingSurfaces::TUI). They tune the rotating object shown in the
 # empty Warp Agent CLI state and aren't present in the GUI settings UI, so they
-# aren't documented in the all-settings reference.
-appearance.zero_state.object -> internal
-appearance.zero_state.rotation_period_seconds -> internal
+# are documented in the CLI configuration page's start screen section.
+# extrusion_depth stays internal: it is a rendering detail of the built-in
+# object with no documented user-facing behavior.
+appearance.zero_state.object -> src/content/docs/cli/configuration.mdx
+appearance.zero_state.rotation_period_seconds -> src/content/docs/cli/configuration.mdx
 appearance.zero_state.extrusion_depth -> internal
 
 # Warp Agent CLI-only (crates/warp_tui) per-section visibility toggles for the
 # zero state (surface: SettingSurfaces::TUI in app/src/settings/tui_zero_state.rs).
 # Each hides one section of the Warp Agent CLI empty state. They aren't present in
-# the GUI settings UI, so they aren't documented in the all-settings reference.
-appearance.zero_state.show_signed_in_user -> internal
-appearance.zero_state.show_changelog -> internal
-appearance.zero_state.show_project_info -> internal
-appearance.zero_state.show_mcp -> internal
-appearance.zero_state.show_animation -> internal
+# the GUI settings UI, so they are documented in the CLI configuration page's
+# start screen section.
+appearance.zero_state.show_signed_in_user -> src/content/docs/cli/configuration.mdx
+appearance.zero_state.show_changelog -> src/content/docs/cli/configuration.mdx
+appearance.zero_state.show_project_info -> src/content/docs/cli/configuration.mdx
+appearance.zero_state.show_mcp -> src/content/docs/cli/configuration.mdx
+appearance.zero_state.show_animation -> src/content/docs/cli/configuration.mdx
 
 # Warp Agent CLI-only toggle that stops the zero-state animation from repainting
 # while the terminal is unfocused (app/src/settings/tui_zero_state.rs). Like the
@@ -618,6 +631,11 @@ OpenWarpLaunchModal
 # One-time launch modal announcing multi-agent orchestration; the feature itself
 # is documented via RunAgentsTool -> orchestration/multi-agent-runs.mdx.
 OrchestrationLaunchModal
+# One-time launch modal announcing the Warp Agent CLI (app/src/workspace/view/
+# agent_cli_launch_modal/). It shows once, links out to the CLI's get-started
+# page, and has no recurring user-facing surface of its own. The CLI it
+# announces is documented at src/content/docs/cli/.
+AgentCliLaunchModal
 GetStartedTab
 CreateProjectFlow
 # Account-first onboarding is an internal login/onboarding flow variant with no

diff --git a/.agents/skills/missing_docs/references/surface_snapshot.json b/.agents/skills/missing_docs/references/surface_snapshot.json
@@ -12,6 +12,7 @@
     "APIKeyManagement": "ga",
     "AccountFirstOnboarding": "ga",
     "ActiveConversationRequiresInteraction": "ga",
+    "AgentCliLaunchModal": "ga",
     "AgentDecidesCommandExecution": "ga",
     "AgentHarness": "ga",
     "AgentManagementDetailsView": "ga",
@@ -871,6 +872,7 @@
     "GET /api/v1/memory_stores/{uid}/memories/{memoryUid}",
     "GET /api/v1/memory_stores/{uid}/memories/{memoryUid}/versions",
     "GET /api/v1/oauth/authorize",
+    "GET /api/v1/oauth/consent/info",
     "GET /api/v1/oauth/jwks.json",
     "PATCH /api/v1/agent/runs/{runId}/event-sequence",
     "PATCH /api/v1/factory/{uid}",
@@ -911,6 +913,7 @@
     "POST /api/v1/harness-support/upload-snapshot",
     "POST /api/v1/memory_stores",
     "POST /api/v1/memory_stores/{uid}/memories",
+    "POST /api/v1/oauth/consent",
     "POST /api/v1/oauth/device/auth",
     "POST /api/v1/oauth/session",
     "POST /api/v1/oauth/token",
@@ -936,6 +939,7 @@
     "/cloud-agent",
     "/compact",
     "/compact-and",
+    "/connect-grok",
     "/continue-locally",
     "/conversations",
     "/copy-debugging-id",
@@ -957,6 +961,7 @@
     "/index",
     "/init",
     "/logout",
+    "/manage-billing",
     "/mcp",
     "/model",
     "/natural-language-detection",
@@ -982,6 +987,7 @@
     "/status",
     "/statusline",
     "/theme",
+    "/upgrade",
     "/usage",
     "/view-logs",
     "/vim-mode",