From ac6885ec51fe900b4b4deb0dcac7d03896c6a49f Mon Sep 17 00:00:00 2001 From: hongyi-chen Date: Wed, 13 May 2026 16:10:29 +0000 Subject: [PATCH] docs(audit): fix path resolution and document VerticalTabsSummaryMode Repair the missing_docs audit script so it no longer produces false positives, refresh the feature surface map to match the live docs structure, and document the Vertical Tabs "Summary" tab item mode that shipped behind the VerticalTabsSummaryMode GA flag. Changes: - audit_docs.py: resolve mapped paths against the actual repo root (the prior code joined paths against docs_root.parent and double-counted src/content/docs/...). Accept .mdx as an alternate to .md and index.mdx as an alternate to README.md, matching the Astro Starlight layout. Fall back to a content search before flagging a mapped path as missing so renamed docs don't get flagged. - feature_surface_map.md: update mappings that pointed at the legacy agent-platform/warp-agents/ tree to the real agent-platform/capabilities/ and agent-platform/local-agents/ locations. Add VerticalTabsSummaryMode -> vertical-tabs.mdx. Move OpenWarpLaunchModal to the ignore list (one-time open-source launch modal; covered in the 2026 changelog). - vertical-tabs.mdx: document the new "Tab item" setting with "Focused session" and "Summary" options, including the table row and the key-features bullet. After the fix, the audit reports zero medium-or-higher severity gaps. Co-Authored-By: Claude Opus 4.7 (1M context) Co-Authored-By: Oz --- .../references/feature_surface_map.md | 143 +++++++++--------- .../skills/missing_docs/scripts/audit_docs.py | 52 +++++-- .../docs/terminal/windows/vertical-tabs.mdx | 4 +- 3 files changed, 118 insertions(+), 81 deletions(-) diff --git a/.agents/skills/missing_docs/references/feature_surface_map.md b/.agents/skills/missing_docs/references/feature_surface_map.md index ccf0eb02..05dbdc66 100644 --- a/.agents/skills/missing_docs/references/feature_surface_map.md +++ b/.agents/skills/missing_docs/references/feature_surface_map.md @@ -12,40 +12,40 @@ Lines starting with `#` are comments. Blank lines are ignored. ## Feature flags -> doc pages -AgentMode -> src/content/docs/agent-platform/warp-agents/README.md +AgentMode -> src/content/docs/agent-platform/local-agents/overview.mdx AgentManagementView -> src/content/docs/agent-platform/cloud-agents/managing-cloud-agents.md AgentManagementDetailsView -> src/content/docs/agent-platform/cloud-agents/managing-cloud-agents.md -AgentModeComputerUse -> src/content/docs/agent-platform/warp-agents/computer-use.md +AgentModeComputerUse -> src/content/docs/agent-platform/capabilities/computer-use.mdx AgentModeWorkflows -> src/content/docs/knowledge-and-collaboration/warp-drive/workflows.md AgentOnboarding -> src/content/docs/agent-platform/getting-started/agents-in-warp.md -AIRules -> src/content/docs/agent-platform/warp-agents/rules.md -AIResumeButton -> src/content/docs/agent-platform/warp-agents/interacting-with-agents/terminal-and-agent-modes.md +AIRules -> src/content/docs/agent-platform/capabilities/rules.mdx +AIResumeButton -> src/content/docs/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx CodeReviewView -> src/content/docs/code/code-review.md -InlineCodeReview -> src/content/docs/agent-platform/warp-agents/interactive-code-review.md +InlineCodeReview -> src/content/docs/agent-platform/local-agents/interactive-code-review.mdx FileTree -> src/content/docs/code/code-editor/file-tree.md CodeFindReplace -> src/content/docs/code/code-editor/find-and-replace.md VimCodeEditor -> src/content/docs/code/code-editor/code-editor-vim-keybindings.md -McpServer -> src/content/docs/agent-platform/warp-agents/mcp.md -McpOauth -> src/content/docs/agent-platform/warp-agents/mcp.md -ImageAsContext -> src/content/docs/agent-platform/warp-agents/agent-context/images-as-context.md -SelectionAsContext -> src/content/docs/agent-platform/warp-agents/agent-context/selection-as-context.md -DiffSetAsContext -> src/content/docs/agent-platform/warp-agents/agent-context/selection-as-context.md -WebSearchUI -> src/content/docs/agent-platform/warp-agents/web-search.md -WebFetchUI -> src/content/docs/agent-platform/warp-agents/web-search.md -CodebaseContext -> src/content/docs/agent-platform/warp-agents/codebase-context.md -CrossRepoContext -> src/content/docs/agent-platform/warp-agents/codebase-context.md -FullSourceCodeEmbedding -> src/content/docs/agent-platform/warp-agents/codebase-context.md -SearchCodebaseUI -> src/content/docs/agent-platform/warp-agents/codebase-context.md +McpServer -> src/content/docs/agent-platform/capabilities/mcp.mdx +McpOauth -> src/content/docs/agent-platform/capabilities/mcp.mdx +ImageAsContext -> src/content/docs/agent-platform/local-agents/agent-context/images-as-context.mdx +SelectionAsContext -> src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx +DiffSetAsContext -> src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx +WebSearchUI -> src/content/docs/agent-platform/capabilities/web-search.mdx +WebFetchUI -> src/content/docs/agent-platform/capabilities/web-search.mdx +CodebaseContext -> src/content/docs/agent-platform/capabilities/codebase-context.mdx +CrossRepoContext -> src/content/docs/agent-platform/capabilities/codebase-context.mdx +FullSourceCodeEmbedding -> src/content/docs/agent-platform/capabilities/codebase-context.mdx +SearchCodebaseUI -> src/content/docs/agent-platform/capabilities/codebase-context.mdx CloudEnvironments -> src/content/docs/agent-platform/cloud-agents/environments.md CloudMode -> src/content/docs/agent-platform/cloud-agents/overview.md AmbientAgentsCommandLine -> src/content/docs/agent-platform/cloud-agents/overview.md ScheduledAmbientAgents -> src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents.md WarpManagedSecrets -> src/content/docs/agent-platform/cloud-agents/secrets.md IntegrationCommand -> src/content/docs/reference/cli/integration-setup.md -ConversationManagement -> src/content/docs/agent-platform/warp-agents/cloud-conversations.md -ForkConversationFromBlock -> src/content/docs/agent-platform/warp-agents/interacting-with-agents/conversation-forking.md -Voice -> src/content/docs/agent-platform/warp-agents/interacting-with-agents/voice.md -WarpDrive -> src/content/docs/knowledge-and-collaboration/warp-drive/README.md +ConversationManagement -> src/content/docs/agent-platform/local-agents/cloud-conversations.mdx +ForkConversationFromBlock -> src/content/docs/agent-platform/local-agents/interacting-with-agents/conversation-forking.mdx +Voice -> src/content/docs/agent-platform/local-agents/interacting-with-agents/voice.mdx +WarpDrive -> src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx EnvVars -> src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.md CommandPaletteFileSearch -> src/content/docs/terminal/command-palette.md Themes -> src/content/docs/terminal/appearance/themes.md @@ -66,73 +66,74 @@ UsageBasedPricing -> src/content/docs/support-and-community/plans-and-billing/cr APIKeyAuthentication -> src/content/docs/reference/cli/api-keys.md APIKeyManagement -> src/content/docs/reference/cli/api-keys.md SecretRedaction -> src/content/docs/support-and-community/privacy-and-security/secret-redaction.md -CreatingSharedSessions -> src/content/docs/knowledge-and-collaboration/session-sharing/README.md -AgentSharedSessions -> src/content/docs/agent-platform/warp-agents/session-sharing.md -ProfilesDesignRevamp -> src/content/docs/agent-platform/warp-agents/agent-profiles-permissions.md -MultiProfile -> src/content/docs/agent-platform/warp-agents/agent-profiles-permissions.md -InlineProfileSelector -> src/content/docs/agent-platform/warp-agents/agent-profiles-permissions.md -ModelChoice -> src/content/docs/agent-platform/warp-agents/model-choice.md -Skills -> src/content/docs/agent-platform/warp-agents/skills.md -ListSkills -> src/content/docs/agent-platform/warp-agents/skills.md -BundledSkills -> src/content/docs/agent-platform/warp-agents/skills.md -Planning -> src/content/docs/agent-platform/warp-agents/planning.md -SyncAmbientPlans -> src/content/docs/agent-platform/warp-agents/planning.md -TaskLists -> src/content/docs/agent-platform/warp-agents/task-lists.md -SlashCommands -> src/content/docs/agent-platform/warp-agents/slash-commands.md -SuggestedRules -> src/content/docs/agent-platform/warp-agents/rules.md +CreatingSharedSessions -> src/content/docs/knowledge-and-collaboration/session-sharing/index.mdx +AgentSharedSessions -> src/content/docs/agent-platform/local-agents/session-sharing.mdx +ProfilesDesignRevamp -> src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx +MultiProfile -> src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx +InlineProfileSelector -> src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx +ModelChoice -> src/content/docs/agent-platform/capabilities/model-choice.mdx +Skills -> src/content/docs/agent-platform/capabilities/skills.mdx +ListSkills -> src/content/docs/agent-platform/capabilities/skills.mdx +BundledSkills -> src/content/docs/agent-platform/capabilities/skills.mdx +Planning -> src/content/docs/agent-platform/capabilities/planning.mdx +SyncAmbientPlans -> src/content/docs/agent-platform/capabilities/planning.mdx +TaskLists -> src/content/docs/agent-platform/capabilities/task-lists.mdx +SlashCommands -> src/content/docs/agent-platform/capabilities/slash-commands.mdx +SuggestedRules -> src/content/docs/agent-platform/capabilities/rules.mdx RectSelection -> src/content/docs/terminal/more-features/text-selection.md -ContextWindowUsageV2 -> src/content/docs/agent-platform/warp-agents/interacting-with-agents/README.md +ContextWindowUsageV2 -> src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx ConfigurableBlockLimits -> src/content/docs/terminal/blocks/block-basics.md CommandCorrectionKey -> src/content/docs/terminal/entry/command-corrections.md ClassicCompletions -> src/content/docs/terminal/command-completions/completions.md DynamicWorkflowEnums -> src/content/docs/knowledge-and-collaboration/warp-drive/workflows.md -SharedWithMe -> src/content/docs/knowledge-and-collaboration/warp-drive/README.md -WarpPacks -> src/content/docs/knowledge-and-collaboration/warp-drive/README.md -TabbedEditorView -> src/content/docs/code/code-editor/README.md -ReadImageFiles -> src/content/docs/agent-platform/warp-agents/agent-context/images-as-context.md -FileRetrievalTools -> src/content/docs/agent-platform/warp-agents/codebase-context.md -ConversationArtifacts -> src/content/docs/agent-platform/warp-agents/interacting-with-agents/README.md -OzChangelogUpdates -> src/content/docs/changelog/README.md -ActiveConversationRequiresInteraction -> src/content/docs/agent-platform/warp-agents/interacting-with-agents/README.md +SharedWithMe -> src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx +WarpPacks -> src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx +TabbedEditorView -> src/content/docs/code/code-editor/index.mdx +ReadImageFiles -> src/content/docs/agent-platform/local-agents/agent-context/images-as-context.mdx +FileRetrievalTools -> src/content/docs/agent-platform/capabilities/codebase-context.mdx +ConversationArtifacts -> src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx +OzChangelogUpdates -> src/content/docs/changelog/index.mdx +ActiveConversationRequiresInteraction -> src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx # Recently shipped GA features -VerticalTabs -> src/content/docs/terminal/windows/vertical-tabs.md -TabConfigs -> src/content/docs/terminal/windows/tab-configs.md +VerticalTabs -> src/content/docs/terminal/windows/vertical-tabs.mdx +VerticalTabsSummaryMode -> src/content/docs/terminal/windows/vertical-tabs.mdx +TabConfigs -> src/content/docs/terminal/windows/tab-configs.mdx PluggableNotifications -> src/content/docs/terminal/more-features/notifications.md -RevertToCheckpoints -> src/content/docs/agent-platform/warp-agents/slash-commands.md -RewindSlashCommand -> src/content/docs/agent-platform/warp-agents/slash-commands.md -ForkFromCommand -> src/content/docs/agent-platform/warp-agents/slash-commands.md -SummarizationConversationCommand -> src/content/docs/agent-platform/warp-agents/slash-commands.md +RevertToCheckpoints -> src/content/docs/agent-platform/capabilities/slash-commands.mdx +RewindSlashCommand -> src/content/docs/agent-platform/capabilities/slash-commands.mdx +ForkFromCommand -> src/content/docs/agent-platform/capabilities/slash-commands.mdx +SummarizationConversationCommand -> src/content/docs/agent-platform/capabilities/slash-commands.mdx CodeReviewFind -> src/content/docs/code/code-review.md CodeReviewSaveChanges -> src/content/docs/code/code-review.md DiscardPerFileAndAllChanges -> src/content/docs/code/code-review.md AutoOpenCodeReviewPane -> src/content/docs/code/code-review.md GitOperationsInCodeReview -> src/content/docs/code/code-review.md -AgentView -> src/content/docs/agent-platform/warp-agents/interacting-with-agents/terminal-and-agent-modes.md -AgentViewBlockContext -> src/content/docs/agent-platform/warp-agents/agent-context/blocks-as-context.md -CloudConversations -> src/content/docs/agent-platform/warp-agents/cloud-conversations.md +AgentView -> src/content/docs/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx +AgentViewBlockContext -> src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx +CloudConversations -> src/content/docs/agent-platform/local-agents/cloud-conversations.mdx CloudModeFromLocalSession -> src/content/docs/agent-platform/cloud-agents/overview.md TeamApiKeys -> src/content/docs/reference/cli/api-keys.md -PRCommentsSlashCommand -> src/content/docs/agent-platform/warp-agents/slash-commands.md -PRCommentsV2 -> src/content/docs/agent-platform/warp-agents/interacting-with-agents/README.md +PRCommentsSlashCommand -> src/content/docs/agent-platform/capabilities/slash-commands.mdx +PRCommentsV2 -> src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx CLIAgentRichInput -> src/content/docs/agent-platform/cli-agents/rich-input.md -HOANotifications -> src/content/docs/agent-platform/warp-agents/agent-notifications.md +HOANotifications -> src/content/docs/agent-platform/capabilities/agent-notifications.mdx OpenCodeNotifications -> src/content/docs/agent-platform/cli-agents/opencode.md CodexNotifications -> src/content/docs/agent-platform/cli-agents/codex.md HOARemoteControl -> src/content/docs/agent-platform/cli-agents/remote-control.md GlobalSearch -> src/content/docs/code/overview.md -FileBasedMcp -> src/content/docs/agent-platform/warp-agents/mcp.md -ConversationsAsContext -> src/content/docs/agent-platform/warp-agents/agent-context/blocks-as-context.md -GithubPrPromptChip -> src/content/docs/agent-platform/warp-agents/agent-notifications.md -AskUserQuestion -> src/content/docs/agent-platform/warp-agents/interacting-with-agents/README.md -AIContextMenuEnabled -> src/content/docs/agent-platform/warp-agents/agent-context/using-to-add-context.md -AtMenuOutsideOfAIMode -> src/content/docs/agent-platform/warp-agents/agent-context/using-to-add-context.md -AIContextMenuCode -> src/content/docs/agent-platform/warp-agents/agent-context/using-to-add-context.md -DriveObjectsAsContext -> src/content/docs/agent-platform/warp-agents/agent-context/using-to-add-context.md +FileBasedMcp -> src/content/docs/agent-platform/capabilities/mcp.mdx +ConversationsAsContext -> src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx +GithubPrPromptChip -> src/content/docs/agent-platform/capabilities/agent-notifications.mdx +AskUserQuestion -> src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx +AIContextMenuEnabled -> src/content/docs/agent-platform/local-agents/agent-context/using-to-add-context.mdx +AtMenuOutsideOfAIMode -> src/content/docs/agent-platform/local-agents/agent-context/using-to-add-context.mdx +AIContextMenuCode -> src/content/docs/agent-platform/local-agents/agent-context/using-to-add-context.mdx +DriveObjectsAsContext -> src/content/docs/agent-platform/local-agents/agent-context/using-to-add-context.mdx KittyKeyboardProtocol -> src/content/docs/terminal/more-features/full-screen-apps.md -InlineRepoMenu -> src/content/docs/agent-platform/warp-agents/codebase-context.md -InlineHistoryMenu -> src/content/docs/agent-platform/warp-agents/interacting-with-agents/terminal-and-agent-modes.md -SkillArguments -> src/content/docs/agent-platform/warp-agents/skills.md +InlineRepoMenu -> src/content/docs/agent-platform/capabilities/codebase-context.mdx +InlineHistoryMenu -> src/content/docs/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx +SkillArguments -> src/content/docs/agent-platform/capabilities/skills.mdx ## CLI commands -> doc pages @@ -157,9 +158,9 @@ oz harness-support -> internal ## API endpoints -> doc pages # Public API endpoints -POST /agent/run -> src/content/docs/reference/api-and-sdk/README.md -GET /agent/runs -> src/content/docs/reference/api-and-sdk/README.md -GET /agent/runs/{runId} -> src/content/docs/reference/api-and-sdk/README.md +POST /agent/run -> src/content/docs/reference/api-and-sdk/index.mdx +GET /agent/runs -> src/content/docs/reference/api-and-sdk/index.mdx +GET /agent/runs/{runId} -> src/content/docs/reference/api-and-sdk/index.mdx # Internal/infrastructure endpoints (not part of public API, no docs needed) GET /block/embed/:id -> internal @@ -241,6 +242,10 @@ NewTabStyling AmbientAgentsRTC OzBranding OzLaunchModal +# One-time launch modal announcing Warp going open-source. +# The announcement itself is covered in the 2026 changelog ("Warp is now open source.") +# and the modal has no recurring user-facing surface that warrants its own doc page. +OpenWarpLaunchModal GetStartedTab CreateProjectFlow CodeLaunchModal diff --git a/.agents/skills/missing_docs/scripts/audit_docs.py b/.agents/skills/missing_docs/scripts/audit_docs.py index e2cd9acd..a11b1b00 100755 --- a/.agents/skills/missing_docs/scripts/audit_docs.py +++ b/.agents/skills/missing_docs/scripts/audit_docs.py @@ -138,6 +138,26 @@ def read_all_docs_text(docs_root: Path) -> dict[str, str]: return result +def resolve_doc_path(doc_path: str, repo_root: Path) -> Path | None: + """Return the first existing variant of a mapped doc path. + + The surface map historically used `.md` and `README.md`, but the live + repo is Astro Starlight (`.mdx` files, `index.mdx` landing pages). + Treat those variants as equivalent so the audit doesn't flag pages that + exist under a sibling extension. + """ + candidates = [repo_root / doc_path] + if doc_path.endswith(".md"): + candidates.append(repo_root / (doc_path[:-3] + ".mdx")) + if doc_path.endswith("README.md"): + candidates.append(repo_root / doc_path.replace("README.md", "index.mdx")) + candidates.append(repo_root / doc_path.replace("README.md", "index.md")) + for candidate in candidates: + if candidate.exists(): + return candidate + return None + + def camel_to_search_terms(flag_name: str) -> list[str]: """Convert a CamelCase flag name into searchable terms. @@ -254,6 +274,10 @@ def audit_features(warp_internal: Path, docs_root: Path, surface_map: dict, ignore_flags = surface_map.get("ignore_flags", set()) feature_to_doc = surface_map.get("feature_to_doc", {}) + # Mapped paths in feature_surface_map.md are repo-root relative + # (e.g., "src/content/docs/..."), so resolve against the repo root. + repo_root = DOCS_REPO_ROOT[0] or docs_root.parent.parent.parent + findings = [] for flag in flags: # Skip ignored flags @@ -271,18 +295,23 @@ def audit_features(warp_internal: Path, docs_root: Path, surface_map: dict, # Check if mapped in surface map if flag in feature_to_doc: doc_path = feature_to_doc[flag] - full_path = docs_root.parent / doc_path - if full_path.exists(): + if resolve_doc_path(doc_path, repo_root) is not None: continue # Mapped and doc exists — verified - else: - findings.append({ - "flag": flag, - "search_terms": camel_to_search_terms(flag), - "severity": "high", - "suggested_doc_path": doc_path, - "reason": f"Mapped doc {doc_path} does not exist", - }) + # Mapped path missing — before flagging, fall back to a content + # search so we don't raise false positives when a doc has merely + # been moved. + terms = camel_to_search_terms(flag) + matches = search_docs_for_terms(docs_text, terms) + if matches: continue + findings.append({ + "flag": flag, + "search_terms": terms, + "severity": "high", + "suggested_doc_path": doc_path, + "reason": f"Mapped doc {doc_path} does not exist", + }) + continue # Not in surface map — search docs for mentions terms = camel_to_search_terms(flag) @@ -370,6 +399,7 @@ def audit_cli(warp_internal: Path, docs_root: Path, surface_map: dict, """Audit CLI command coverage in docs.""" commands = parse_cli_commands(warp_internal) cli_to_doc = surface_map.get("cli_to_doc", {}) + repo_root = DOCS_REPO_ROOT[0] or docs_root.parent.parent.parent # Read all CLI docs content cli_docs_dir = docs_root / "reference" / "cli" @@ -392,7 +422,7 @@ def audit_cli(warp_internal: Path, docs_root: Path, surface_map: dict, # intentionally have no public docs (matches API audit semantics). if doc_path == "internal": continue - if (docs_root.parent / doc_path).exists(): + if resolve_doc_path(doc_path, repo_root) is not None: continue # Mapped and exists # Search CLI docs for the command name diff --git a/src/content/docs/terminal/windows/vertical-tabs.mdx b/src/content/docs/terminal/windows/vertical-tabs.mdx index 2137af19..40584403 100644 --- a/src/content/docs/terminal/windows/vertical-tabs.mdx +++ b/src/content/docs/terminal/windows/vertical-tabs.mdx @@ -26,6 +26,7 @@ Vertical tabs are especially useful when running multiple coding agents side by ### Display modes and customization * **Pane or tab view** - Display every split pane as its own row (**Panes**) or show only the focused pane per tab (**Tabs**). +* **Focused session or summary tab item** - When viewing as **Tabs**, choose **Focused session** to show the active pane per tab, or **Summary** to show a condensed multi-line digest of every pane in the tab (commands, working directories, branches, and status badges). * **Compact and expanded modes** - Choose between a dense single-line view (default) or a detailed multi-line layout with full metadata. * **Configurable pane titles** - Control which metadata appears first: last command or conversation, working directory, or Git branch. * **Hover detail sidecar** - Hover any pane row to see full, un-clipped metadata in a floating detail card without changing focus. @@ -92,7 +93,8 @@ You can also rearrange the panel toggle buttons at the top of the Warp window | Setting | Availability | Options | Default | |---|---|---|---| -| **View as** | Always | **Panes** — each split pane gets its own row. **Tabs** — only the focused pane per tab is shown. | Panes | +| **View as** | Always | **Panes** — each split pane gets its own row. **Tabs** — one row per tab, controlled further by the **Tab item** setting. | Panes | +| **Tab item** | **View as** is set to **Tabs** | **Focused session** — show the focused pane's title and metadata. **Summary** — show a condensed digest of every pane in the tab, with command or conversation titles, working directories, branches, and agent status badges (up to three lines, with a `+ N more` overflow row). | Focused session | | **Density** | Always | **Compact** — smaller rows with title and optional subtitle. **Expanded** — larger rows with title, description, and metadata. | Compact | | **Pane title as** | Always | **Command / Conversation** — last command, conversation title, or CLI agent session name.
**Working Directory** — pane's working directory.
**Branch** — checked-out Git branch. | Command / Conversation | | **Additional metadata** | Compact mode only | **Branch**
**Working Directory**
**Command / Conversation**
(options depend on the **Pane title as** setting; duplicates are excluded). | Branch |