Document all remaining Oz CLI subcommands + new SSH setting

.agents/skills/missing_docs/references/feature_surface_map.md

@@ -125,6 +125,31 @@ ConfigurableToolbar -> src/content/docs/terminal/windows/configurable-toolbar.md
 SettingsFile -> src/content/docs/terminal/settings/index.mdx
 Changelog -> src/content/docs/changelog/index.mdx
 Autoupdate -> src/content/docs/support-and-community/troubleshooting-and-support/updating-warp.mdx
+ShellSelector -> src/content/docs/getting-started/supported-shells.mdx
+WorkflowAliases -> src/content/docs/terminal/entry/yaml-workflows.mdx
+KittyImages -> src/content/docs/terminal/more-features/full-screen-apps.mdx
+UndoClosedPanes -> src/content/docs/terminal/windows/tabs.mdx
+RevertDiffHunk -> src/content/docs/code/code-review.md
+SshRemoteServer -> src/content/docs/terminal/warpify/ssh.md
+
+# Session sharing (viewing + ACLs are part of the documented session sharing feature)
+ViewingSharedSessions -> src/content/docs/knowledge-and-collaboration/session-sharing/index.mdx
+SessionSharingAcls -> src/content/docs/knowledge-and-collaboration/session-sharing/index.mdx
+SharedSessionWriteToLongRunningCommands -> src/content/docs/knowledge-and-collaboration/session-sharing/index.mdx
+
+# CLI-gated features documented in the CLI reference
+ArtifactCommand -> src/content/docs/reference/cli/artifacts.mdx
+OzIdentityFederation -> src/content/docs/reference/cli/federate.mdx
+
+# Third-party harness support
+AgentHarness -> src/content/docs/agent-platform/cloud-agents/harnesses/index.mdx
+
+# Image context for cloud agents
+AmbientAgentsImageUpload -> src/content/docs/agent-platform/local-agents/agent-context/images-as-context.mdx
+CloudModeImageContext -> src/content/docs/agent-platform/local-agents/agent-context/images-as-context.mdx
+
+# Skills on the Oz platform
+OzPlatformSkills -> src/content/docs/agent-platform/capabilities/skills.mdx
 
 # Handoff (local <-> cloud, cloud <-> cloud) and snapshots
 OzHandoff -> src/content/docs/agent-platform/cloud-agents/handoff/index.mdx
@@ -144,6 +169,8 @@ NamedAgents -> src/content/docs/agent-platform/cloud-agents/agents.mdx
 # Inference: BYOK and custom endpoints
 SoloUserByok -> src/content/docs/agent-platform/inference/bring-your-own-api-key.mdx
 CustomInferenceEndpoints -> src/content/docs/agent-platform/inference/custom-inference-endpoint.mdx
+# Connect a SuperGrok subscription instead of pasting an xAI API key.
+SuperGrok -> src/content/docs/agent-platform/inference/bring-your-own-api-key.mdx
 
 # Billing & Usage settings page (redesigned)
 BillingAndUsagePageV2 -> src/content/docs/support-and-community/plans-and-billing/index.mdx
@@ -229,10 +256,17 @@ POST /harness-support/upload-snapshot -> internal
 # for exceptions: settings documented on another page (`section.key -> path`)
 # or intentionally undocumented (`section.key -> internal`).
 
+# One-shot internal UI state for the tmux SSH deprecation notice (description
+# is marked "Internal:" in the settings registry); not a user preference.
+warpify.ssh.ssh_tmux_deprecation_notice_pending -> internal
+
 ## Unlisted docs pages to ignore
 
 # Pages intentionally absent from src/sidebar.ts (one slug per line, e.g.
 # `guides/some-page`). Everything else on disk must be reachable via the sidebar.
+# Per the page's frontmatter comment: not in the Guides sidebar yet, pending
+# team feedback.
+guides/agent-workflows/warp-vs-claude-code
 
 ## Flags to ignore (internal-only, not user-facing)
 
@@ -280,7 +314,6 @@ DefaultAdeberryTheme
 AutoupdateUIRevamp
 MinimalistUI
 AvatarInTabBar
-SessionSharingAcls
 ImeMarkedText
 NewTabStyling
 AmbientAgentsRTC
@@ -297,9 +330,9 @@ CreateProjectFlow
 CodeLaunchModal
 ValidateAutosuggestions
 ClearAutosuggestionOnEscape
-OzPlatformSkills
-# Rendering detail for markdown tables in notebooks/AI output; no dedicated doc surface.
+# Rendering details for markdown tables/Mermaid in notebooks/AI output; no dedicated doc surface.
 MarkdownTables
+MarkdownMermaid
 
 # UI implementation details (not user-facing features)
 FallbackModelLoadOutputMessaging
@@ -338,36 +371,27 @@ GitCredentialRefresh
 OrchestrationViewerStreamer
 OwnerOrchestrationAncestorStreamer
 
-# Non-GA flags in dogfood/preview only
+# Sub-feature toggles and pre-launch flags. Section placement does NOT assert
+# rollout status (the audit computes that from code); entries here are ignored
+# because the toggle itself isn't a documentable surface, or because the
+# feature isn't user-facing yet — the snapshot diff flags promotions.
 LSPAsATool
-SshRemoteServer
 EmbeddedCodeReviewComments
 InteractiveConversationManagementView
 MarkdownImages
-MarkdownMermaid
 EditableMarkdownMermaid
-OzIdentityFederation
-AgentHarness
+# Directory-based tab colors: the user-facing knob is the setting
+# appearance.tabs.directory_tab_colors, documented in the all-settings reference.
 DirectoryTabColors
-ArtifactCommand
-CloudModeImageContext
 CloudModeHostSelector
-AmbientAgentsImageUpload
 CodebaseIndexSpeedbump
 CodebaseIndexPersistence
-SharedSessionWriteToLongRunningCommands
 AgentTips
 AgentViewPromptChip
 AllowOpeningFileLinksUsingEditorEnv
 AllowIgnoringInputSuggestions
 CodeModeChip
-UndoClosedPanes
-RevertDiffHunk
-ViewingSharedSessions
-ShellSelector
-FullScreenZenMode
-WorkflowAliases
-KittyImages
+# Internal agent file-search tool plumbing (read tools are not individually documented).
 GrepTool
 NativeShellCompletions
 WelcomeTab
@@ -384,5 +408,7 @@ PredictAMQueries
 UseTantivySearch
 CommandCorrectionsHistoryRule
 SuggestedAgentModeWorkflows
+# Implementation toggle choosing skill-based vs slash-command PR comments;
+# the user-facing /pr-comments command is mapped via PRCommentsSlashCommand.
 PRCommentsSkill
 FigmaDetection

.agents/skills/missing_docs/references/surface_snapshot.json

@@ -223,7 +223,6 @@
     "RunAgentsTool": "ga",
     "RunGeneratorsWithCmdExe": "dogfood",
     "RuntimeFeatureFlags": "other",
-    "SSHTmuxWrapper": "dogfood",
     "ScheduledAmbientAgents": "ga",
     "SearchCodebaseUI": "ga",
     "SelectablePrompt": "other",
@@ -937,6 +936,7 @@
     "cloud_platform.third_party_api_keys.aws_bedrock_credentials_enabled": "always_on",
     "cloud_platform.third_party_api_keys.aws_bedrock_profile": "always_on",
     "cloud_platform.third_party_api_keys.can_use_warp_credits_with_byok": "always_on",
+    "cloud_platform.third_party_api_keys.gemini_enterprise_credentials_enabled": "always_on",
     "code.editor.auto_open_code_review_pane_on_first_agent_change": "always_on",
     "code.editor.open_code_panels_file_editor": "always_on",
     "code.editor.open_file_editor": "always_on",
@@ -1025,8 +1025,10 @@
     "warp_drive.sorting_choice": "always_on",
     "warpify.ssh.enable_legacy_ssh_wrapper": "always_on",
     "warpify.ssh.enable_ssh_warpification": "always_on",
+    "warpify.ssh.reuse_existing_control_master": "always_on",
     "warpify.ssh.ssh_extension_install_mode": "always_on",
     "warpify.ssh.ssh_hosts_denylist": "always_on",
+    "warpify.ssh.ssh_tmux_deprecation_notice_pending": "always_on",
     "warpify.ssh.use_ssh_tmux_wrapper": "always_on",
     "warpify.subshells.added_subshell_commands": "always_on",
     "warpify.subshells.subshell_commands_denylist": "always_on",