From de7db4999cf6ba7fb278e52447b26b6bbcd02a09 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Fri, 1 May 2026 12:10:24 -0600 Subject: [PATCH 1/8] docs: add sidebar nav labels and fix sentence case across 94 pages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Audit and restore sidebar nav labels that were lost during the GitBook to Astro Starlight migration. Adds sidebar.label frontmatter to 94 pages: - Restore shortened nav labels from GitBook SUMMARY.md (e.g., 'Warp Drive Notebooks' shows as 'Notebooks' in sidebar, 'Terminal Block Basics' shows as 'Block basics') - Fix sentence case on nav labels per style guide (e.g., 'Block Actions' → 'Block actions', 'MCP Servers' → 'MCP servers') - Fix sentence case on existing guide sidebar.labels (12 guide pages) - Leave H1 titles unchanged (separate work) - Leave sidebar.ts structural overrides unchanged Co-Authored-By: Oz --- src/content/docs/agent-platform/cli-agents/overview.mdx | 2 ++ .../docs/agent-platform/cloud-agents/deployment-patterns.mdx | 2 ++ src/content/docs/agent-platform/cloud-agents/faqs.mdx | 2 ++ .../cloud-agents/integrations/cloud-providers.mdx | 2 ++ .../cloud-agents/integrations/demo-issue-triage-bot.mdx | 2 ++ .../cloud-agents/integrations/quickstart-github-actions.mdx | 2 ++ .../agent-platform/cloud-agents/integrations/quickstart.mdx | 2 ++ .../docs/agent-platform/cloud-agents/managing-cloud-agents.mdx | 2 ++ src/content/docs/agent-platform/cloud-agents/mcp.mdx | 2 ++ src/content/docs/agent-platform/cloud-agents/overview.mdx | 2 ++ src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx | 2 ++ src/content/docs/agent-platform/cloud-agents/platform.mdx | 2 ++ src/content/docs/agent-platform/cloud-agents/quickstart.mdx | 2 ++ .../agent-platform/cloud-agents/self-hosting/managed-direct.mdx | 2 ++ .../agent-platform/cloud-agents/self-hosting/managed-docker.mdx | 2 ++ .../cloud-agents/self-hosting/managed-kubernetes.mdx | 2 ++ .../agent-platform/cloud-agents/self-hosting/quickstart.mdx | 2 ++ .../cloud-agents/self-hosting/troubleshooting.mdx | 2 ++ .../docs/agent-platform/cloud-agents/self-hosting/unmanaged.mdx | 2 ++ .../docs/agent-platform/cloud-agents/skills-as-agents.mdx | 2 ++ .../cloud-agents/team-access-billing-and-identity.mdx | 2 ++ .../cloud-agents/triggers/scheduled-agents-quickstart.mdx | 2 ++ .../agent-platform/cloud-agents/triggers/scheduled-agents.mdx | 2 ++ .../agent-platform/cloud-agents/viewing-cloud-agent-runs.mdx | 2 ++ .../docs/code/code-editor/code-editor-vim-keybindings.mdx | 2 ++ src/content/docs/code/code-editor/find-and-replace.mdx | 2 ++ src/content/docs/code/git-worktrees.mdx | 2 ++ .../enterprise/getting-started/getting-started-enterprise.mdx | 2 ++ src/content/docs/enterprise/team-management/admin-panel.mdx | 2 ++ src/content/docs/getting-started/keyboard-shortcuts.mdx | 2 ++ src/content/docs/getting-started/supported-shells.mdx | 2 ++ .../how-to-configure-yolo-and-strategic-agent-profiles.mdx | 2 +- ...-rules-for-an-existing-project-astro-typescript-tailwind.mdx | 2 +- .../how-to-set-up-self-serve-data-analytics-with-skills.mdx | 2 +- .../trigger-reusable-actions-with-saved-prompts.mdx | 2 +- .../docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx | 2 +- .../context7-mcp-update-astro-project-with-best-practices.mdx | 2 +- ...mote-mcp-create-a-website-from-a-figma-file-from-scratch.mdx | 2 +- .../github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx | 2 +- .../linear-mcp-updating-tickets-with-a-lean-build-approach.mdx | 2 +- .../puppeteer-mcp-scraping-amazon-web-reviews.mdx | 2 +- .../sentry-mcp-fix-sentry-error-in-empower-website.mdx | 2 +- ...e-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx | 2 +- .../warp-drive/agent-mode-context.mdx | 2 ++ .../docs/knowledge-and-collaboration/warp-drive/notebooks.mdx | 2 ++ .../docs/knowledge-and-collaboration/warp-drive/prompts.mdx | 2 ++ .../docs/knowledge-and-collaboration/warp-drive/workflows.mdx | 2 ++ src/content/docs/reference/api-and-sdk/quickstart.mdx | 2 ++ src/content/docs/reference/cli/agent-profiles.mdx | 2 ++ src/content/docs/reference/cli/api-keys.mdx | 2 ++ src/content/docs/reference/cli/integration-setup.mdx | 2 ++ src/content/docs/reference/cli/mcp-servers.mdx | 2 ++ src/content/docs/reference/cli/quickstart.mdx | 2 ++ src/content/docs/reference/cli/skills.mdx | 2 ++ src/content/docs/reference/cli/warp-drive.mdx | 2 ++ .../support-and-community/community/open-source-licenses.mdx | 2 ++ .../docs/support-and-community/community/refer-a-friend.mdx | 2 ++ .../plans-and-billing/plans-pricing-refunds.mdx | 2 ++ .../logging-out-and-uninstalling.mdx | 2 ++ .../troubleshooting-and-support/sending-us-feedback.mdx | 2 ++ src/content/docs/terminal/appearance/blocks-behavior.mdx | 2 ++ src/content/docs/terminal/appearance/custom-themes.mdx | 2 ++ src/content/docs/terminal/appearance/pane-dimming.mdx | 2 ++ src/content/docs/terminal/appearance/prompt.mdx | 2 ++ src/content/docs/terminal/appearance/size-opacity-blurring.mdx | 2 ++ src/content/docs/terminal/appearance/tabs-behavior.mdx | 2 ++ src/content/docs/terminal/appearance/text-fonts-cursor.mdx | 2 ++ src/content/docs/terminal/appearance/themes.mdx | 2 ++ src/content/docs/terminal/blocks/background-blocks.mdx | 2 ++ src/content/docs/terminal/blocks/block-actions.mdx | 2 ++ src/content/docs/terminal/blocks/block-basics.mdx | 2 ++ src/content/docs/terminal/blocks/block-filtering.mdx | 2 ++ src/content/docs/terminal/blocks/block-sharing.mdx | 2 ++ src/content/docs/terminal/blocks/find.mdx | 2 ++ src/content/docs/terminal/editor/alias-expansion.mdx | 2 ++ src/content/docs/terminal/editor/command-inspector.mdx | 2 ++ src/content/docs/terminal/editor/syntax-error-highlighting.mdx | 2 ++ src/content/docs/terminal/editor/vim.mdx | 2 ++ src/content/docs/terminal/entry/command-corrections.mdx | 2 ++ src/content/docs/terminal/entry/command-history.mdx | 2 ++ src/content/docs/terminal/entry/command-search.mdx | 2 ++ src/content/docs/terminal/entry/synchronized-inputs.mdx | 2 ++ src/content/docs/terminal/entry/yaml-workflows.mdx | 2 ++ src/content/docs/terminal/integrations-and-plugins.mdx | 2 ++ src/content/docs/terminal/more-features/files-and-links.mdx | 2 ++ src/content/docs/terminal/more-features/markdown-viewer.mdx | 2 ++ src/content/docs/terminal/more-features/notifications.mdx | 2 ++ src/content/docs/terminal/more-features/settings-sync.mdx | 2 ++ src/content/docs/terminal/more-features/uri-scheme.mdx | 2 ++ src/content/docs/terminal/more-features/working-directory.mdx | 2 ++ src/content/docs/terminal/sessions/session-navigation.mdx | 2 ++ src/content/docs/terminal/sessions/session-restoration.mdx | 2 ++ src/content/docs/terminal/windows/global-hotkey.mdx | 2 ++ src/content/docs/terminal/windows/vertical-tabs.mdx | 2 ++ 94 files changed, 176 insertions(+), 12 deletions(-) diff --git a/src/content/docs/agent-platform/cli-agents/overview.mdx b/src/content/docs/agent-platform/cli-agents/overview.mdx index 6403b66..0087b19 100644 --- a/src/content/docs/agent-platform/cli-agents/overview.mdx +++ b/src/content/docs/agent-platform/cli-agents/overview.mdx @@ -3,6 +3,8 @@ title: Third-Party CLI Agents description: >- Warp provides first-class support for third-party CLI coding agents with a rich input editor, notifications, code review, and more. +sidebar: + label: "Overview" --- Warp auto-detects supported CLI agents and enhances them with IDE-level features — a rich input editor, agent notifications, inline code review, remote session control, and more. Run your preferred coding agent inside Warp and get a better experience out of the box. diff --git a/src/content/docs/agent-platform/cloud-agents/deployment-patterns.mdx b/src/content/docs/agent-platform/cloud-agents/deployment-patterns.mdx index f2242b0..d3ae1bf 100644 --- a/src/content/docs/agent-platform/cloud-agents/deployment-patterns.mdx +++ b/src/content/docs/agent-platform/cloud-agents/deployment-patterns.mdx @@ -3,6 +3,8 @@ title: Deployment Patterns description: >- Common architectures for deploying cloud agents, including CLI-only, Oz-hosted, and self-hosted execution patterns. +sidebar: + label: "Deployment patterns" --- Teams adopt cloud agents in a few repeatable ways. This page outlines the most common architectures, what they're good for, and how they fit together. diff --git a/src/content/docs/agent-platform/cloud-agents/faqs.mdx b/src/content/docs/agent-platform/cloud-agents/faqs.mdx index 2027a9e..265a84f 100644 --- a/src/content/docs/agent-platform/cloud-agents/faqs.mdx +++ b/src/content/docs/agent-platform/cloud-agents/faqs.mdx @@ -3,6 +3,8 @@ title: Cloud Agent FAQs description: >- Frequently asked questions about cloud agents, including where agents run, how runs work, supported models, security, and common workflows. +sidebar: + label: "Cloud agent FAQs" --- This page answers common questions about cloud agents, including where they run, how they're configured, and how teams use cloud agents for day-to-day engineering work. diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/cloud-providers.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/cloud-providers.mdx index 641f218..b3c99ce 100644 --- a/src/content/docs/agent-platform/cloud-agents/integrations/cloud-providers.mdx +++ b/src/content/docs/agent-platform/cloud-agents/integrations/cloud-providers.mdx @@ -2,6 +2,8 @@ title: Cloud Providers (Preview) description: >- Connect Oz cloud agents to your AWS and GCP services. +sidebar: + label: "AWS, GCP, and other cloud providers" --- Oz cloud agents can securely access cloud providers using short-lived OpenID Connect credentials. diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/demo-issue-triage-bot.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/demo-issue-triage-bot.mdx index f6eb4b9..53d009b 100644 --- a/src/content/docs/agent-platform/cloud-agents/integrations/demo-issue-triage-bot.mdx +++ b/src/content/docs/agent-platform/cloud-agents/integrations/demo-issue-triage-bot.mdx @@ -3,6 +3,8 @@ title: "Demo: Issue Triage Bot" description: >- A walkthrough demo showing how to trigger a cloud agent from a GitHub Action to automatically triage bug reports and create draft pull requests. +sidebar: + label: "Demo: Issue triage bot" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/quickstart-github-actions.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/quickstart-github-actions.mdx index 8e22e22..82e28bb 100644 --- a/src/content/docs/agent-platform/cloud-agents/integrations/quickstart-github-actions.mdx +++ b/src/content/docs/agent-platform/cloud-agents/integrations/quickstart-github-actions.mdx @@ -3,6 +3,8 @@ title: GitHub Actions quickstart description: >- Set up your first Oz agent in GitHub Actions in ~10 minutes. Run agents as workflow steps to automate code review and issue triage. +sidebar: + label: "Quickstart" --- Add Oz agents to your GitHub Actions workflows with [`oz-agent-action`](https://github.com/warpdotdev/oz-agent-action). This quickstart walks you through setting up your first GitHub Actions integration: a PR review workflow that automatically analyzes pull requests and posts inline review comments. diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/quickstart.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/quickstart.mdx index d3b2d3f..b411e5f 100644 --- a/src/content/docs/agent-platform/cloud-agents/integrations/quickstart.mdx +++ b/src/content/docs/agent-platform/cloud-agents/integrations/quickstart.mdx @@ -3,6 +3,8 @@ title: Integrations quickstart description: >- Trigger your first Oz agent from Slack in ~15 minutes and get results in-thread. +sidebar: + label: "Quickstart" --- Oz integrations let you trigger cloud agents directly from the tools your team already uses. This guide walks you through connecting Oz to Slack. Once set up, anyone on your team can tag @Oz in a message or thread to kick off a cloud agent that runs the task and posts results back to the conversation. diff --git a/src/content/docs/agent-platform/cloud-agents/managing-cloud-agents.mdx b/src/content/docs/agent-platform/cloud-agents/managing-cloud-agents.mdx index fdab182..2c87987 100644 --- a/src/content/docs/agent-platform/cloud-agents/managing-cloud-agents.mdx +++ b/src/content/docs/agent-platform/cloud-agents/managing-cloud-agents.mdx @@ -4,6 +4,8 @@ description: >- Monitor and manage cloud agent activity across your team with Warp's centralized management view, including filtering, status tracking, and session inspection. +sidebar: + label: "Managing cloud agents" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/agent-platform/cloud-agents/mcp.mdx b/src/content/docs/agent-platform/cloud-agents/mcp.mdx index 4374c3b..9ebe8a8 100644 --- a/src/content/docs/agent-platform/cloud-agents/mcp.mdx +++ b/src/content/docs/agent-platform/cloud-agents/mcp.mdx @@ -3,6 +3,8 @@ title: MCP Servers description: >- Connect cloud agents to external tools, APIs, and internal services using MCP servers. +sidebar: + label: "MCP servers" --- Cloud agents can call external tools through [Model Context Protocol (MCP) servers](/agent-platform/capabilities/mcp/). This lets agents reach beyond the terminal to automatically interact with systems like GitHub, dbt, Sentry, or any custom internal service, whenever the workflow requires it. diff --git a/src/content/docs/agent-platform/cloud-agents/overview.mdx b/src/content/docs/agent-platform/cloud-agents/overview.mdx index ff4689c..559a47c 100644 --- a/src/content/docs/agent-platform/cloud-agents/overview.mdx +++ b/src/content/docs/agent-platform/cloud-agents/overview.mdx @@ -3,6 +3,8 @@ title: Cloud Agents Overview description: >- Run background agents in the cloud from events, schedules, or integrations with team-wide observability. +sidebar: + label: "Cloud agents overview" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx b/src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx index 9579de0..f8e96fe 100644 --- a/src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx +++ b/src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx @@ -3,6 +3,8 @@ title: Oz Web App description: >- Use the Oz web app to manage cloud agents, view runs, create schedules, and configure environments and integrations from any browser or mobile device. +sidebar: + label: "Oz web app" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/agent-platform/cloud-agents/platform.mdx b/src/content/docs/agent-platform/cloud-agents/platform.mdx index 9e1dd88..c2e1101 100644 --- a/src/content/docs/agent-platform/cloud-agents/platform.mdx +++ b/src/content/docs/agent-platform/cloud-agents/platform.mdx @@ -3,6 +3,8 @@ title: Oz Platform description: >- The Oz Platform provides the CLI, API/SDK, orchestration, environments, and observability for cloud agents. +sidebar: + label: "Oz platform" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/agent-platform/cloud-agents/quickstart.mdx b/src/content/docs/agent-platform/cloud-agents/quickstart.mdx index e2e3ce9..efc00b5 100644 --- a/src/content/docs/agent-platform/cloud-agents/quickstart.mdx +++ b/src/content/docs/agent-platform/cloud-agents/quickstart.mdx @@ -4,6 +4,8 @@ description: >- Learn how to run your first Oz cloud agent in ~10 minutes. Cloud agents run in remote environments, enabling automation, scheduling, and team collaboration. +sidebar: + label: "Quickstart" --- **Oz cloud agents** run in a remote environment and can be triggered from events, schedules, integrations, or manually. This enables scaling agents off your laptop, automating development tasks, and building apps on top of agents. Oz handles the orchestration, execution, and observability. diff --git a/src/content/docs/agent-platform/cloud-agents/self-hosting/managed-direct.mdx b/src/content/docs/agent-platform/cloud-agents/self-hosting/managed-direct.mdx index b2182d9..4122931 100644 --- a/src/content/docs/agent-platform/cloud-agents/self-hosting/managed-direct.mdx +++ b/src/content/docs/agent-platform/cloud-agents/self-hosting/managed-direct.mdx @@ -3,6 +3,8 @@ title: "Managed: Direct backend" description: >- Run the Oz managed worker with the Direct backend to execute cloud agent tasks directly on the host, without Docker or Kubernetes. +sidebar: + label: "Managed: Direct" --- Run the `oz-agent-worker` daemon with the **Direct backend** — tasks execute directly on the worker host without Docker or Kubernetes. Oz still orchestrates runs end to end (Slack, Linear, schedules, API, `oz agent run-cloud`); the worker just runs the agent in a per-task workspace on its own filesystem. diff --git a/src/content/docs/agent-platform/cloud-agents/self-hosting/managed-docker.mdx b/src/content/docs/agent-platform/cloud-agents/self-hosting/managed-docker.mdx index c3bcd0b..b633faa 100644 --- a/src/content/docs/agent-platform/cloud-agents/self-hosting/managed-docker.mdx +++ b/src/content/docs/agent-platform/cloud-agents/self-hosting/managed-docker.mdx @@ -3,6 +3,8 @@ title: "Managed: Docker backend" description: >- Run the Oz managed worker daemon with the Docker backend to execute cloud agent tasks in isolated containers on your infrastructure. +sidebar: + label: "Managed: Docker" --- Run the `oz-agent-worker` daemon with the **Docker backend** — the default managed path. Each agent task runs in an isolated Docker container spawned from the worker, with full orchestration by Oz (Slack, Linear, schedules, API, `oz agent run-cloud`). diff --git a/src/content/docs/agent-platform/cloud-agents/self-hosting/managed-kubernetes.mdx b/src/content/docs/agent-platform/cloud-agents/self-hosting/managed-kubernetes.mdx index cfdf77a..df89b14 100644 --- a/src/content/docs/agent-platform/cloud-agents/self-hosting/managed-kubernetes.mdx +++ b/src/content/docs/agent-platform/cloud-agents/self-hosting/managed-kubernetes.mdx @@ -3,6 +3,8 @@ title: "Managed: Kubernetes backend" description: >- Deploy the Oz managed worker into a Kubernetes cluster with the included Helm chart. Each agent task runs as a Kubernetes Job in your cluster. +sidebar: + label: "Managed: Kubernetes" --- Deploy the `oz-agent-worker` daemon into a Kubernetes cluster using the included Helm chart. Each agent task runs as a **Kubernetes Job** in your cluster. Oz orchestrates runs end to end (Slack, Linear, schedules, API, `oz agent run-cloud`); your cluster provides the compute, scheduling, and policy enforcement. diff --git a/src/content/docs/agent-platform/cloud-agents/self-hosting/quickstart.mdx b/src/content/docs/agent-platform/cloud-agents/self-hosting/quickstart.mdx index f4ea59d..d96bb44 100644 --- a/src/content/docs/agent-platform/cloud-agents/self-hosting/quickstart.mdx +++ b/src/content/docs/agent-platform/cloud-agents/self-hosting/quickstart.mdx @@ -3,6 +3,8 @@ title: Self-hosting quickstart description: >- Get a managed self-hosted Oz worker running on Docker and route your first cloud agent run to it in under 10 minutes. +sidebar: + label: "Quickstart" --- Run your first Oz cloud agent on your own infrastructure in ~10 minutes using the managed architecture with the Docker backend — the default and fastest path to self-hosting. diff --git a/src/content/docs/agent-platform/cloud-agents/self-hosting/troubleshooting.mdx b/src/content/docs/agent-platform/cloud-agents/self-hosting/troubleshooting.mdx index b94c7be..d0b90d8 100644 --- a/src/content/docs/agent-platform/cloud-agents/self-hosting/troubleshooting.mdx +++ b/src/content/docs/agent-platform/cloud-agents/self-hosting/troubleshooting.mdx @@ -3,6 +3,8 @@ title: Self-hosting troubleshooting description: >- Diagnose and fix common problems with self-hosted Oz worker daemons across Docker, Kubernetes, and Direct backends. +sidebar: + label: "Troubleshooting" --- Diagnostic guides for the `oz-agent-worker` daemon and its task execution. Use this page when a worker won't start, won't connect, tasks stay queued, or tasks fail. diff --git a/src/content/docs/agent-platform/cloud-agents/self-hosting/unmanaged.mdx b/src/content/docs/agent-platform/cloud-agents/self-hosting/unmanaged.mdx index e80a3d0..d8f7bfd 100644 --- a/src/content/docs/agent-platform/cloud-agents/self-hosting/unmanaged.mdx +++ b/src/content/docs/agent-platform/cloud-agents/self-hosting/unmanaged.mdx @@ -4,6 +4,8 @@ description: >- Run Oz agents in your existing CI, Kubernetes, or dev environments using the oz agent run CLI. You orchestrate the runs; Warp provides tracking and observability. +sidebar: + label: "Unmanaged" --- With the unmanaged architecture, **you orchestrate agent runs** by invoking `oz agent run` directly from your existing CI pipelines, Kubernetes pods, VMs, or dev boxes. The agent runs on whatever host the command is executed from; Warp tracks the session for you but does not start or stop agents. diff --git a/src/content/docs/agent-platform/cloud-agents/skills-as-agents.mdx b/src/content/docs/agent-platform/cloud-agents/skills-as-agents.mdx index 92ed7e5..0715c12 100644 --- a/src/content/docs/agent-platform/cloud-agents/skills-as-agents.mdx +++ b/src/content/docs/agent-platform/cloud-agents/skills-as-agents.mdx @@ -3,6 +3,8 @@ title: Skills as Agents description: >- Run agents based on skills for consistent, repeatable workflows. Use skills with local or cloud agents from the CLI, Oz web app, API, or on a schedule. +sidebar: + label: "Skills as agents" --- You can start an agent from a [skill](/agent-platform/capabilities/skills/)—a reusable set of instructions that defines what the agent should do. When you run an agent based on a skill, the skill provides the base prompt and behavior, while you supply additional context for that specific run. diff --git a/src/content/docs/agent-platform/cloud-agents/team-access-billing-and-identity.mdx b/src/content/docs/agent-platform/cloud-agents/team-access-billing-and-identity.mdx index 97f2d52..9b28fb6 100644 --- a/src/content/docs/agent-platform/cloud-agents/team-access-billing-and-identity.mdx +++ b/src/content/docs/agent-platform/cloud-agents/team-access-billing-and-identity.mdx @@ -4,6 +4,8 @@ description: >- Understand how access to cloud agents works for individuals and teams, how billing and credits apply, and how Warp maps user identities across integrations. +sidebar: + label: "Access, billing, and identity" --- This page explains how access to cloud agents works for both individual users and teams, how billing and credits apply, and how Warp maps user identities across integrations. diff --git a/src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents-quickstart.mdx b/src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents-quickstart.mdx index dd96def..21946c9 100644 --- a/src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents-quickstart.mdx +++ b/src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents-quickstart.mdx @@ -3,6 +3,8 @@ title: Scheduled Agents quickstart description: >- Schedule an Oz cloud agent to run recurring tasks automatically — issue triage, dependency checks, code cleanup, and more. +sidebar: + label: "Quickstart" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents.mdx b/src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents.mdx index 6fc9a56..ebf7968 100644 --- a/src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents.mdx +++ b/src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents.mdx @@ -3,6 +3,8 @@ title: Scheduled Agents description: >- Run cloud agents on a cron schedule for automated maintenance and recurring tasks. +sidebar: + label: "Scheduled agents" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/agent-platform/cloud-agents/viewing-cloud-agent-runs.mdx b/src/content/docs/agent-platform/cloud-agents/viewing-cloud-agent-runs.mdx index d9b5b70..41698cb 100644 --- a/src/content/docs/agent-platform/cloud-agents/viewing-cloud-agent-runs.mdx +++ b/src/content/docs/agent-platform/cloud-agents/viewing-cloud-agent-runs.mdx @@ -3,6 +3,8 @@ title: Cloud agent session sharing description: >- Open, inspect, and steer remote cloud agent runs in real time from Warp or the web. +sidebar: + label: "Viewing cloud agent runs" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/code/code-editor/code-editor-vim-keybindings.mdx b/src/content/docs/code/code-editor/code-editor-vim-keybindings.mdx index 34b4195..cd5c637 100644 --- a/src/content/docs/code/code-editor/code-editor-vim-keybindings.mdx +++ b/src/content/docs/code/code-editor/code-editor-vim-keybindings.mdx @@ -3,6 +3,8 @@ title: Code Editor Vim Keybindings description: >- Use Vim keybindings in Warp's code editor for keyboard-driven navigation and editing. +sidebar: + label: "Code editor Vim keybindings" --- ## About Vim keybindings diff --git a/src/content/docs/code/code-editor/find-and-replace.mdx b/src/content/docs/code/code-editor/find-and-replace.mdx index 7d793a0..073695f 100644 --- a/src/content/docs/code/code-editor/find-and-replace.mdx +++ b/src/content/docs/code/code-editor/find-and-replace.mdx @@ -3,6 +3,8 @@ title: Find and Replace description: >- Search and replace text in Warp's code editor with regex, case sensitivity, and smart case preservation. +sidebar: + label: "Find & replace" --- import DemoVideo from '@components/DemoVideo.astro'; diff --git a/src/content/docs/code/git-worktrees.mdx b/src/content/docs/code/git-worktrees.mdx index 60b3645..a9d73fe 100644 --- a/src/content/docs/code/git-worktrees.mdx +++ b/src/content/docs/code/git-worktrees.mdx @@ -3,6 +3,8 @@ title: Git worktrees description: >- Warp natively supports Git worktrees, letting you work on multiple branches simultaneously with full Code Review, Codebase Context, and Agent support. +sidebar: + label: "Git Worktrees" --- Warp natively supports [Git worktrees](https://git-scm.com/docs/git-worktree) — a Git feature that lets you check out multiple branches simultaneously in separate directories, all backed by the same repository. This is different from simply switching branches: with worktrees, you can have `~/project` on `main` and `~/project-wt/feature-x` on `feature-x` at the same time, with no stashing or context-switching required. diff --git a/src/content/docs/enterprise/getting-started/getting-started-enterprise.mdx b/src/content/docs/enterprise/getting-started/getting-started-enterprise.mdx index d02b2a9..478d07b 100644 --- a/src/content/docs/enterprise/getting-started/getting-started-enterprise.mdx +++ b/src/content/docs/enterprise/getting-started/getting-started-enterprise.mdx @@ -3,6 +3,8 @@ title: Getting started with Warp Enterprise description: >- Set up Warp Enterprise for your organization with SSO configuration, team management, and admin controls. +sidebar: + label: "Getting started for admins" --- This guide walks your IT or platform admin through initial Warp setup for your organization: configuring SSO, creating your team, inviting users, and setting Admin Panel policies. diff --git a/src/content/docs/enterprise/team-management/admin-panel.mdx b/src/content/docs/enterprise/team-management/admin-panel.mdx index 993e94e..03ae0ef 100644 --- a/src/content/docs/enterprise/team-management/admin-panel.mdx +++ b/src/content/docs/enterprise/team-management/admin-panel.mdx @@ -4,6 +4,8 @@ description: >- Centralized management for team administrators to configure Warp settings, control agent behavior, and enforce security policies across your organization. +sidebar: + label: "Admin panel" --- The Admin Panel provides administrators with centralized control over team settings in Warp. Configure agent behavior, security policies, codebase indexing, and collaboration features for your entire organization from a single interface. diff --git a/src/content/docs/getting-started/keyboard-shortcuts.mdx b/src/content/docs/getting-started/keyboard-shortcuts.mdx index 7a3bb91..76affb5 100644 --- a/src/content/docs/getting-started/keyboard-shortcuts.mdx +++ b/src/content/docs/getting-started/keyboard-shortcuts.mdx @@ -2,6 +2,8 @@ title: Keyboard Shortcuts description: >- View, customize, and remap keyboard shortcuts for all Warp features. +sidebar: + label: "Keyboard shortcuts" --- import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/getting-started/supported-shells.mdx b/src/content/docs/getting-started/supported-shells.mdx index 14a05b6..5e37dbe 100644 --- a/src/content/docs/getting-started/supported-shells.mdx +++ b/src/content/docs/getting-started/supported-shells.mdx @@ -4,6 +4,8 @@ description: >- Warp supports bash, zsh, fish, and PowerShell across macOS, Windows, and Warp supports bash, zsh, fish, PowerShell, and WSL2 across macOS, Windows, and Linux. +sidebar: + label: "Supported shells" --- ## Warp default shell diff --git a/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx b/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx index b8f0273..e93c7d6 100644 --- a/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx +++ b/src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx @@ -4,7 +4,7 @@ description: >- Configure custom agent profiles in Warp to control planning depth, autonomy, and execution speed — demonstrated with YOLO and Strategic examples. sidebar: - label: "Configure YOLO and Strategic Agent Profiles" + label: "Configure YOLO and strategic Agent Profiles" --- import VideoEmbed from '@components/VideoEmbed.astro'; import { Steps } from '@astrojs/starlight/components'; diff --git a/src/content/docs/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind.mdx b/src/content/docs/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind.mdx index c0a4e61..7185593 100644 --- a/src/content/docs/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind.mdx +++ b/src/content/docs/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind.mdx @@ -4,7 +4,7 @@ description: >- Create and maintain an AGENTS.md project rules file so coding agents always understand your project's setup, commands, architecture, and conventions. sidebar: - label: "Create Project Rules for an existing project" + label: "Create project Rules for an existing project" --- import VideoEmbed from '@components/VideoEmbed.astro'; import { Steps, FileTree } from '@astrojs/starlight/components'; diff --git a/src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx b/src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx index 65eb99a..d9d78fe 100644 --- a/src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx +++ b/src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx @@ -4,7 +4,7 @@ description: >- Set up a self-serve data analytics workflow in Warp using two community Skills that map questions to dbt models and structure reproducible analyses. sidebar: - label: "Set up self-serve data analytics with Skills" + label: "Set up self-serve data analytics with skills" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx b/src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx index 23617aa..51ac55c 100644 --- a/src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx +++ b/src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx @@ -4,7 +4,7 @@ description: >- Save and share prompts in Warp Drive to automate commits, code reviews, and PR creation across your team. sidebar: - label: "Trigger reusable actions with Saved Prompts" + label: "Trigger reusable actions with saved prompts" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx b/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx index 3a08f43..e692ae4 100644 --- a/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx +++ b/src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx @@ -4,7 +4,7 @@ description: >- Use Warp to pull, organize, and analyze Cloud Run production logs by severity with natural language prompts and automated Python scripts. sidebar: - label: "Analyze Cloud Run logs" + label: "Analyze cloud run logs" --- import VideoEmbed from '@components/VideoEmbed.astro'; import { Steps } from '@astrojs/starlight/components'; diff --git a/src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx b/src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx index d2d513e..cce05fc 100644 --- a/src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx +++ b/src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx @@ -4,7 +4,7 @@ description: >- Use the Context7 MCP server to give Warp agents real-time access to framework documentation for automated project upgrades. sidebar: - label: "Context7 MCP: Update Astro project with best practices" + label: "Context7 MCP: update Astro project with best practices" --- import VideoEmbed from '@components/VideoEmbed.astro'; import { Steps } from '@astrojs/starlight/components'; diff --git a/src/content/docs/guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch.mdx b/src/content/docs/guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch.mdx index ae54a50..f7c4ec1 100644 --- a/src/content/docs/guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch.mdx +++ b/src/content/docs/guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch.mdx @@ -4,7 +4,7 @@ description: >- Connect Warp to Figma's remote MCP server via OAuth and generate front-end code directly from your design files. sidebar: - label: "Figma Remote MCP: Create a website from a Figma file from scratch" + label: "Figma remote MCP: create a website from a Figma file" --- import VideoEmbed from '@components/VideoEmbed.astro'; import { Steps } from '@astrojs/starlight/components'; diff --git a/src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx b/src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx index 20ec8f5..651354b 100644 --- a/src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx +++ b/src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx @@ -4,7 +4,7 @@ description: >- Connect the GitHub MCP server to Warp to summarize open PRs, create issues from TODO comments, and automate repo management. sidebar: - label: "GitHub MCP: Summarize open PRs and create GitHub issues" + label: "GitHub MCP: summarize open PRs and create GitHub issues" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx b/src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx index 5387984..6fb4999 100644 --- a/src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx +++ b/src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx @@ -4,7 +4,7 @@ description: >- Use Warp's Linear MCP integration to update ticket descriptions, propagate changes to subtasks, and maintain a lean build strategy. sidebar: - label: "Linear MCP: Update tickets with a lean build approach" + label: "Linear MCP: update tickets with a lean build approach" --- import VideoEmbed from '@components/VideoEmbed.astro'; import { Steps } from '@astrojs/starlight/components'; diff --git a/src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx b/src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx index ac50f50..0e0798f 100644 --- a/src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx +++ b/src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx @@ -4,7 +4,7 @@ description: >- Configure the Puppeteer MCP server in Warp to automate browser tasks like navigating sites, scraping product data, and analyzing reviews. sidebar: - label: "Puppeteer MCP: Scrape Amazon web reviews" + label: "Puppeteer MCP: scrape Amazon web reviews" --- import VideoEmbed from '@components/VideoEmbed.astro'; import { Steps } from '@astrojs/starlight/components'; diff --git a/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx b/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx index 28780ec..7f07f7c 100644 --- a/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx +++ b/src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx @@ -4,7 +4,7 @@ description: >- Connect the Sentry MCP server to Warp, fetch live error data, diagnose stack traces, and auto-generate fixes for production issues. sidebar: - label: "Sentry MCP: Fix Sentry error in Empower website" + label: "Sentry MCP: fix Sentry error in empower website" --- import VideoEmbed from '@components/VideoEmbed.astro'; import { Steps } from '@astrojs/starlight/components'; diff --git a/src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx b/src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx index aec41f8..9ded16a 100644 --- a/src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx +++ b/src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx @@ -4,7 +4,7 @@ description: >- Connect SQLite and Stripe MCP servers to Warp and run conversational queries against your local database and payment data. sidebar: - label: "SQLite and Stripe MCP: Basic queries you can make after setup" + label: "SQLite and Stripe MCP: basic queries you can make after setup" --- import VideoEmbed from '@components/VideoEmbed.astro'; import { Steps } from '@astrojs/starlight/components'; diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/agent-mode-context.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/agent-mode-context.mdx index 541831a..79e885f 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/agent-mode-context.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/agent-mode-context.mdx @@ -3,6 +3,8 @@ title: Agent Mode Context description: >- Agents use your Warp Drive content—Workflows, Notebooks, Rules, MCP Servers, and Environment Variables—for context-aware responses. +sidebar: + label: "Agent Mode context" --- [Agent Mode](/agent-platform/local-agents/interacting-with-agents/) can leverage your [Warp Drive](/knowledge-and-collaboration/warp-drive/) contents to tailor responses to your personal and team developer workflows and environments. diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/notebooks.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/notebooks.mdx index 4dd741c..e9fc91d 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/notebooks.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/notebooks.mdx @@ -2,6 +2,8 @@ title: Warp Drive Notebooks description: >- Save interactive playbooks to simplify onboarding and development. +sidebar: + label: "Notebooks" --- import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx index be4239a..8be413d 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx @@ -2,6 +2,8 @@ title: Warp Drive prompts description: >- Save and reuse parameterized Agent Mode prompts to run on-demand. +sidebar: + label: "Prompts" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/workflows.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/workflows.mdx index eeb6baf..b0a5fd2 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/workflows.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/workflows.mdx @@ -3,6 +3,8 @@ title: Warp Drive Workflows description: >- Save parameterized commands as Workflows and execute them on-demand from Warp Drive. +sidebar: + label: "Workflows" --- import DemoVideo from '@components/DemoVideo.astro'; import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/reference/api-and-sdk/quickstart.mdx b/src/content/docs/reference/api-and-sdk/quickstart.mdx index 3204a12..f347205 100644 --- a/src/content/docs/reference/api-and-sdk/quickstart.mdx +++ b/src/content/docs/reference/api-and-sdk/quickstart.mdx @@ -3,6 +3,8 @@ title: "API & SDK quickstart" description: >- Create and monitor your first cloud agent run via the Oz API or SDK in ~5 minutes. +sidebar: + label: "Quickstart" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/reference/cli/agent-profiles.mdx b/src/content/docs/reference/cli/agent-profiles.mdx index 51b858b..575f3e4 100644 --- a/src/content/docs/reference/cli/agent-profiles.mdx +++ b/src/content/docs/reference/cli/agent-profiles.mdx @@ -3,6 +3,8 @@ title: Agent profiles description: >- Use agent profiles with the Oz CLI to control what the agent can access, how it behaves, and where it can act. +sidebar: + label: "Agent Profiles" --- Agent profiles control three things: diff --git a/src/content/docs/reference/cli/api-keys.mdx b/src/content/docs/reference/cli/api-keys.mdx index cc02aa6..f4f5c91 100644 --- a/src/content/docs/reference/cli/api-keys.mdx +++ b/src/content/docs/reference/cli/api-keys.mdx @@ -2,6 +2,8 @@ title: API keys description: >- Create and manage API keys for authenticating the Oz CLI and cloud agents. +sidebar: + label: "API Keys" --- API keys let the Oz CLI and cloud agents authenticate without human interaction. Use API keys for CI pipelines, headless servers, VMs, Codespaces, containers, and other automated environments. diff --git a/src/content/docs/reference/cli/integration-setup.mdx b/src/content/docs/reference/cli/integration-setup.mdx index 9a9074f..27dfa16 100644 --- a/src/content/docs/reference/cli/integration-setup.mdx +++ b/src/content/docs/reference/cli/integration-setup.mdx @@ -3,6 +3,8 @@ title: Integration setup description: >- Learn how to set up environments and integrations so you can trigger Oz agents from external tools. +sidebar: + label: "Integration Setup" --- This article describes the environment and integration setup that is required before you can trigger agents from external tools, like Slack or Linear. You will learn how to: diff --git a/src/content/docs/reference/cli/mcp-servers.mdx b/src/content/docs/reference/cli/mcp-servers.mdx index 81dc72a..a77f7c5 100644 --- a/src/content/docs/reference/cli/mcp-servers.mdx +++ b/src/content/docs/reference/cli/mcp-servers.mdx @@ -3,6 +3,8 @@ title: MCP servers description: >- Connect agents to external tools like GitHub, Linear, and Sentry by passing MCP servers to the --mcp flag as a UUID, inline JSON, or file path. +sidebar: + label: "MCP Servers" --- MCP servers connect agents to external systems like GitHub, Linear, or Sentry. To use a [Model Context Protocol (MCP)](/agent-platform/capabilities/mcp/) server from the CLI, use the `--mcp` flag with `oz agent run` or `oz agent run-cloud`. diff --git a/src/content/docs/reference/cli/quickstart.mdx b/src/content/docs/reference/cli/quickstart.mdx index 608cb81..d887f80 100644 --- a/src/content/docs/reference/cli/quickstart.mdx +++ b/src/content/docs/reference/cli/quickstart.mdx @@ -2,6 +2,8 @@ title: Quick Start description: >- Set up and run your first cloud agent via the Oz CLI in less than 5 minutes. +sidebar: + label: "Quickstart" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/reference/cli/skills.mdx b/src/content/docs/reference/cli/skills.mdx index d98c9e8..20ebccd 100644 --- a/src/content/docs/reference/cli/skills.mdx +++ b/src/content/docs/reference/cli/skills.mdx @@ -3,6 +3,8 @@ title: "Skills (CLI)" description: >- Use skills with the Oz CLI to run agents from reusable skill definitions stored in your repositories. +sidebar: + label: "Skills" --- [Skills](/agent-platform/capabilities/skills/) are reusable instruction sets that teach agents how to perform specific tasks. Use the `--skill` flag to run an agent from a skill in a repository accessible to your environment. diff --git a/src/content/docs/reference/cli/warp-drive.mdx b/src/content/docs/reference/cli/warp-drive.mdx index fc7d3ce..3311a9e 100644 --- a/src/content/docs/reference/cli/warp-drive.mdx +++ b/src/content/docs/reference/cli/warp-drive.mdx @@ -3,6 +3,8 @@ title: Warp Drive context description: >- Use saved prompts, notebooks, workflows, and rules from Warp Drive as context in CLI agent commands. +sidebar: + label: "Warp Drive Context" --- ## Reusing saved prompts diff --git a/src/content/docs/support-and-community/community/open-source-licenses.mdx b/src/content/docs/support-and-community/community/open-source-licenses.mdx index e075f76..06afd6c 100644 --- a/src/content/docs/support-and-community/community/open-source-licenses.mdx +++ b/src/content/docs/support-and-community/community/open-source-licenses.mdx @@ -2,6 +2,8 @@ title: Open source licenses description: >- These are the third-party libraries that Warp depends on. +sidebar: + label: "Open Source Licenses" --- This page lists the **third-party** libraries that Warp's client depends on. For Warp's own client source code (open source under AGPL v3), see [Contributing to Warp](/support-and-community/community/contributing/) and [`warpdotdev/warp`](https://github.com/warpdotdev/warp). diff --git a/src/content/docs/support-and-community/community/refer-a-friend.mdx b/src/content/docs/support-and-community/community/refer-a-friend.mdx index 1af5046..3bf4a03 100644 --- a/src/content/docs/support-and-community/community/refer-a-friend.mdx +++ b/src/content/docs/support-and-community/community/refer-a-friend.mdx @@ -3,6 +3,8 @@ title: Refer a friend and earn rewards description: >- Think Warp would be the ideal product for someone you know? You can invite your team or friends within the app and earn rewards. +sidebar: + label: "Refer a Friend & Earn Rewards" --- :::note diff --git a/src/content/docs/support-and-community/plans-and-billing/plans-pricing-refunds.mdx b/src/content/docs/support-and-community/plans-and-billing/plans-pricing-refunds.mdx index badcfe8..4423f9d 100644 --- a/src/content/docs/support-and-community/plans-and-billing/plans-pricing-refunds.mdx +++ b/src/content/docs/support-and-community/plans-and-billing/plans-pricing-refunds.mdx @@ -2,6 +2,8 @@ title: Plans, pricing, and refunds description: >- Learn about Warp's plans and pricing tiers. Get started for free. +sidebar: + label: "Plans, Pricing, & Refunds" --- ## Warp plans and pricing diff --git a/src/content/docs/support-and-community/troubleshooting-and-support/logging-out-and-uninstalling.mdx b/src/content/docs/support-and-community/troubleshooting-and-support/logging-out-and-uninstalling.mdx index 88d5054..cce2b24 100644 --- a/src/content/docs/support-and-community/troubleshooting-and-support/logging-out-and-uninstalling.mdx +++ b/src/content/docs/support-and-community/troubleshooting-and-support/logging-out-and-uninstalling.mdx @@ -2,6 +2,8 @@ title: "Logging out & uninstalling" description: >- How to log out from Warp, and how to uninstall Warp. +sidebar: + label: "Logging Out & Uninstalling" --- import DemoVideo from '@components/DemoVideo.astro'; import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/support-and-community/troubleshooting-and-support/sending-us-feedback.mdx b/src/content/docs/support-and-community/troubleshooting-and-support/sending-us-feedback.mdx index 4ae19e3..c34186c 100644 --- a/src/content/docs/support-and-community/troubleshooting-and-support/sending-us-feedback.mdx +++ b/src/content/docs/support-and-community/troubleshooting-and-support/sending-us-feedback.mdx @@ -3,6 +3,8 @@ title: Sending feedback and logs description: >- Send Warp feedback, bug reports, and feature requests, and gather logs, crash reports, CPU samples, and AI conversation IDs to attach to them. +sidebar: + label: "Sending Feedback & Logs" --- import DemoVideo from '@components/DemoVideo.astro'; import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/terminal/appearance/blocks-behavior.mdx b/src/content/docs/terminal/appearance/blocks-behavior.mdx index 4e4de95..e10b3a4 100644 --- a/src/content/docs/terminal/appearance/blocks-behavior.mdx +++ b/src/content/docs/terminal/appearance/blocks-behavior.mdx @@ -3,6 +3,8 @@ title: Blocks Behavior description: >- Customize Block spacing with Compact mode and toggle Block dividers for a cleaner layout. +sidebar: + label: "Blocks behavior" --- import DemoVideo from '@components/DemoVideo.astro'; diff --git a/src/content/docs/terminal/appearance/custom-themes.mdx b/src/content/docs/terminal/appearance/custom-themes.mdx index 5da9431..6a083b4 100644 --- a/src/content/docs/terminal/appearance/custom-themes.mdx +++ b/src/content/docs/terminal/appearance/custom-themes.mdx @@ -3,6 +3,8 @@ title: Custom Themes description: >- Warp supports Custom Themes which can be created manually or downloaded from our repo. +sidebar: + label: "Custom themes" --- import { Tabs, TabItem } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/appearance/pane-dimming.mdx b/src/content/docs/terminal/appearance/pane-dimming.mdx index d2a6551..4090722 100644 --- a/src/content/docs/terminal/appearance/pane-dimming.mdx +++ b/src/content/docs/terminal/appearance/pane-dimming.mdx @@ -4,6 +4,8 @@ description: >- Warp supports dimming inactive Panes as well as allowing the focus to follow the mouse. This helps you easily see which pane is active and maintain focus. +sidebar: + label: "Pane dimming & focus" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/appearance/prompt.mdx b/src/content/docs/terminal/appearance/prompt.mdx index 5d21770..7ca10b1 100644 --- a/src/content/docs/terminal/appearance/prompt.mdx +++ b/src/content/docs/terminal/appearance/prompt.mdx @@ -3,6 +3,8 @@ title: Terminal prompt description: >- Configure Warp's native prompt with context chips or use your own Shell prompt (PS1). +sidebar: + label: "Prompt" --- import DemoVideo from '@components/DemoVideo.astro'; import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/appearance/size-opacity-blurring.mdx b/src/content/docs/terminal/appearance/size-opacity-blurring.mdx index e9a2b25..8d26b1f 100644 --- a/src/content/docs/terminal/appearance/size-opacity-blurring.mdx +++ b/src/content/docs/terminal/appearance/size-opacity-blurring.mdx @@ -3,6 +3,8 @@ title: "Size, Opacity, & Blurring" description: >- Configure window size, opacity, and background blurring to match your visual preferences. +sidebar: + label: "Size, opacity, & blurring" --- import DemoVideo from '@components/DemoVideo.astro'; import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/appearance/tabs-behavior.mdx b/src/content/docs/terminal/appearance/tabs-behavior.mdx index dc697be..21dd64e 100644 --- a/src/content/docs/terminal/appearance/tabs-behavior.mdx +++ b/src/content/docs/terminal/appearance/tabs-behavior.mdx @@ -3,6 +3,8 @@ title: Tabs Behavior description: >- Customize tab behavior in Warp, including tab indicators, tab bar visibility, and close button position. +sidebar: + label: "Tabs behavior" --- import DemoVideo from '@components/DemoVideo.astro'; diff --git a/src/content/docs/terminal/appearance/text-fonts-cursor.mdx b/src/content/docs/terminal/appearance/text-fonts-cursor.mdx index 12c01ae..02cdcfe 100644 --- a/src/content/docs/terminal/appearance/text-fonts-cursor.mdx +++ b/src/content/docs/terminal/appearance/text-fonts-cursor.mdx @@ -4,6 +4,8 @@ description: >- Warp supports customizing the font and how text is displayed. This can help improve readability and usability. Warp also supports disabling the blinking cursor. +sidebar: + label: "Text, fonts, & cursor" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/appearance/themes.mdx b/src/content/docs/terminal/appearance/themes.mdx index a38582a..d4ae608 100644 --- a/src/content/docs/terminal/appearance/themes.mdx +++ b/src/content/docs/terminal/appearance/themes.mdx @@ -3,6 +3,8 @@ title: Terminal themes description: >- Warp includes several themes (out-of-box) and also supports setting custom themes. +sidebar: + label: "Themes" --- import DemoVideo from '@components/DemoVideo.astro'; import ImageGrid from '@components/ImageGrid.astro'; diff --git a/src/content/docs/terminal/blocks/background-blocks.mdx b/src/content/docs/terminal/blocks/background-blocks.mdx index bf4dcd0..3350047 100644 --- a/src/content/docs/terminal/blocks/background-blocks.mdx +++ b/src/content/docs/terminal/blocks/background-blocks.mdx @@ -2,6 +2,8 @@ title: Background Blocks description: >- How Blocks interact with background process output. +sidebar: + label: "Background blocks" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/blocks/block-actions.mdx b/src/content/docs/terminal/blocks/block-actions.mdx index 502d15d..31cd8bc 100644 --- a/src/content/docs/terminal/blocks/block-actions.mdx +++ b/src/content/docs/terminal/blocks/block-actions.mdx @@ -2,6 +2,8 @@ title: Block Actions description: >- Copy, bookmark, share, search, and filter Blocks using built-in actions. +sidebar: + label: "Block actions" --- import DemoVideo from '@components/DemoVideo.astro'; import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/terminal/blocks/block-basics.mdx b/src/content/docs/terminal/blocks/block-basics.mdx index 99ade3c..b27794e 100644 --- a/src/content/docs/terminal/blocks/block-basics.mdx +++ b/src/content/docs/terminal/blocks/block-basics.mdx @@ -2,6 +2,8 @@ title: Terminal Block Basics description: >- The basics of creating, selecting, and navigating between Blocks. +sidebar: + label: "Block basics" --- import { Tabs, TabItem } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/blocks/block-filtering.mdx b/src/content/docs/terminal/blocks/block-filtering.mdx index 785f3fb..aa1c5f7 100644 --- a/src/content/docs/terminal/blocks/block-filtering.mdx +++ b/src/content/docs/terminal/blocks/block-filtering.mdx @@ -3,6 +3,8 @@ title: Block Filtering description: >- Filter Block output by text, regex, or case to focus on specific matching lines. +sidebar: + label: "Block filtering" --- import DemoVideo from '@components/DemoVideo.astro'; import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/terminal/blocks/block-sharing.mdx b/src/content/docs/terminal/blocks/block-sharing.mdx index 304ba18..48b488f 100644 --- a/src/content/docs/terminal/blocks/block-sharing.mdx +++ b/src/content/docs/terminal/blocks/block-sharing.mdx @@ -2,6 +2,8 @@ title: Block Sharing description: >- Share Blocks with your team as permalinks or embeddable HTML snippets. +sidebar: + label: "Block sharing" --- import DemoVideo from '@components/DemoVideo.astro'; import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/terminal/blocks/find.mdx b/src/content/docs/terminal/blocks/find.mdx index 1597bc9..e39f181 100644 --- a/src/content/docs/terminal/blocks/find.mdx +++ b/src/content/docs/terminal/blocks/find.mdx @@ -3,6 +3,8 @@ title: Terminal Block Find description: >- Search across Blocks from the bottom up, with regex, case-sensitive, and per-Block filtering options. +sidebar: + label: "Block find" --- import DemoVideo from '@components/DemoVideo.astro'; import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/terminal/editor/alias-expansion.mdx b/src/content/docs/terminal/editor/alias-expansion.mdx index 2490f95..cd03ca3 100644 --- a/src/content/docs/terminal/editor/alias-expansion.mdx +++ b/src/content/docs/terminal/editor/alias-expansion.mdx @@ -2,6 +2,8 @@ title: Alias Expansion description: >- Warp will automatically expand your aliases as you type in the input editor. +sidebar: + label: "Alias expansion" --- import { Tabs, TabItem } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/editor/command-inspector.mdx b/src/content/docs/terminal/editor/command-inspector.mdx index 7f24191..8eb8416 100644 --- a/src/content/docs/terminal/editor/command-inspector.mdx +++ b/src/content/docs/terminal/editor/command-inspector.mdx @@ -3,6 +3,8 @@ title: Command Inspector description: >- Command Inspector (also known as Command X-Ray) surfaces documentation for sub-parts of your command, directly in Warp's Input Editor. +sidebar: + label: "Command inspector" --- import { Tabs, TabItem } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/editor/syntax-error-highlighting.mdx b/src/content/docs/terminal/editor/syntax-error-highlighting.mdx index 883c88d..039f6a0 100644 --- a/src/content/docs/terminal/editor/syntax-error-highlighting.mdx +++ b/src/content/docs/terminal/editor/syntax-error-highlighting.mdx @@ -3,6 +3,8 @@ title: "Syntax & Error Highlighting" description: >- Color-code commands and underline errors in real time as you type in Warp's input editor. +sidebar: + label: "Syntax & error highlighting" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/editor/vim.mdx b/src/content/docs/terminal/editor/vim.mdx index bc5bf63..5b196f3 100644 --- a/src/content/docs/terminal/editor/vim.mdx +++ b/src/content/docs/terminal/editor/vim.mdx @@ -3,6 +3,8 @@ title: Input editor Vim keybindings description: >- Use input editor Vim keybindings (also known as Vim mode) to edit commands quickly in Warp. +sidebar: + label: "Vim keybindings" --- ## About Vim keybindings diff --git a/src/content/docs/terminal/entry/command-corrections.mdx b/src/content/docs/terminal/entry/command-corrections.mdx index 2fde331..7c98538 100644 --- a/src/content/docs/terminal/entry/command-corrections.mdx +++ b/src/content/docs/terminal/entry/command-corrections.mdx @@ -3,6 +3,8 @@ title: Command Corrections description: >- Command Corrections provides auto-correct suggestions on previously run commands to catch typos and forgotten flags, and fix general console errors. +sidebar: + label: "Command corrections" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/entry/command-history.mdx b/src/content/docs/terminal/entry/command-history.mdx index 02de58d..291bab4 100644 --- a/src/content/docs/terminal/entry/command-history.mdx +++ b/src/content/docs/terminal/entry/command-history.mdx @@ -2,6 +2,8 @@ title: Command History description: >- Command History helps you quickly find previously run commands. +sidebar: + label: "Command history" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/entry/command-search.mdx b/src/content/docs/terminal/entry/command-search.mdx index 1611568..5e68f2e 100644 --- a/src/content/docs/terminal/entry/command-search.mdx +++ b/src/content/docs/terminal/entry/command-search.mdx @@ -3,6 +3,8 @@ title: Command Search description: >- Search command history, Workflows, Prompts, and agent conversations with fuzzy matching. +sidebar: + label: "Command search" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/entry/synchronized-inputs.mdx b/src/content/docs/terminal/entry/synchronized-inputs.mdx index adca454..ee2c3da 100644 --- a/src/content/docs/terminal/entry/synchronized-inputs.mdx +++ b/src/content/docs/terminal/entry/synchronized-inputs.mdx @@ -2,6 +2,8 @@ title: Synchronized Inputs description: >- Type a command once and sync it to multiple panes simultaneously. +sidebar: + label: "Synchronized inputs" --- import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/terminal/entry/yaml-workflows.mdx b/src/content/docs/terminal/entry/yaml-workflows.mdx index 62a7b13..8b545e4 100644 --- a/src/content/docs/terminal/entry/yaml-workflows.mdx +++ b/src/content/docs/terminal/entry/yaml-workflows.mdx @@ -2,6 +2,8 @@ title: YAML Workflows description: >- Workflows are an easier way to execute and share commands within Warp. +sidebar: + label: "YAML workflows" --- import DemoVideo from '@components/DemoVideo.astro'; import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/terminal/integrations-and-plugins.mdx b/src/content/docs/terminal/integrations-and-plugins.mdx index 7373f5c..341521a 100644 --- a/src/content/docs/terminal/integrations-and-plugins.mdx +++ b/src/content/docs/terminal/integrations-and-plugins.mdx @@ -3,6 +3,8 @@ title: Terminal Integrations description: >- Warp's terminal functionality extends and integrates with popular development tools. +sidebar: + label: "Terminal integrations" --- import DemoVideo from '@components/DemoVideo.astro'; import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/terminal/more-features/files-and-links.mdx b/src/content/docs/terminal/more-features/files-and-links.mdx index c0d837e..7315b95 100644 --- a/src/content/docs/terminal/more-features/files-and-links.mdx +++ b/src/content/docs/terminal/more-features/files-and-links.mdx @@ -2,6 +2,8 @@ title: "Files, Links, & Scripts" description: >- Quickly open links and files or run scripts with your mouse. +sidebar: + label: "Files, links, & scripts" --- import DemoVideo from '@components/DemoVideo.astro'; import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/terminal/more-features/markdown-viewer.mdx b/src/content/docs/terminal/more-features/markdown-viewer.mdx index d5d7a58..60dfea8 100644 --- a/src/content/docs/terminal/more-features/markdown-viewer.mdx +++ b/src/content/docs/terminal/more-features/markdown-viewer.mdx @@ -2,6 +2,8 @@ title: Markdown Viewer description: >- Open Markdown files in your terminal and run commands. +sidebar: + label: "Markdown viewer" --- import DemoVideo from '@components/DemoVideo.astro'; import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/terminal/more-features/notifications.mdx b/src/content/docs/terminal/more-features/notifications.mdx index 86a2df2..a92a6c6 100644 --- a/src/content/docs/terminal/more-features/notifications.mdx +++ b/src/content/docs/terminal/more-features/notifications.mdx @@ -3,6 +3,8 @@ title: Desktop Notifications description: >- Receive desktop notifications when long-running commands complete or need your input. +sidebar: + label: "Desktop notifications" --- import { Tabs, TabItem } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/more-features/settings-sync.mdx b/src/content/docs/terminal/more-features/settings-sync.mdx index e3d60c3..694df17 100644 --- a/src/content/docs/terminal/more-features/settings-sync.mdx +++ b/src/content/docs/terminal/more-features/settings-sync.mdx @@ -3,6 +3,8 @@ title: Settings Sync description: >- Keep your Warp settings consistent across devices and sessions with cloud-based sync. +sidebar: + label: "Settings Sync (Beta)" --- ## How to toggle settings sync diff --git a/src/content/docs/terminal/more-features/uri-scheme.mdx b/src/content/docs/terminal/more-features/uri-scheme.mdx index c39aeb9..3c1c4e7 100644 --- a/src/content/docs/terminal/more-features/uri-scheme.mdx +++ b/src/content/docs/terminal/more-features/uri-scheme.mdx @@ -3,6 +3,8 @@ title: Warp URI Scheme description: >- Warps URI scheme enables you to programmatically open new windows, tabs, or launch configurations with ease. +sidebar: + label: "Warp URI scheme" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/more-features/working-directory.mdx b/src/content/docs/terminal/more-features/working-directory.mdx index 4835bf5..77b9698 100644 --- a/src/content/docs/terminal/more-features/working-directory.mdx +++ b/src/content/docs/terminal/more-features/working-directory.mdx @@ -4,6 +4,8 @@ description: >- Set a default working directory for new Warp sessions, with options for home directory, previous session, custom path, or per-window/tab/pane configuration. +sidebar: + label: "Working directory" --- import DemoVideo from '@components/DemoVideo.astro'; diff --git a/src/content/docs/terminal/sessions/session-navigation.mdx b/src/content/docs/terminal/sessions/session-navigation.mdx index fe1e8b8..f18004e 100644 --- a/src/content/docs/terminal/sessions/session-navigation.mdx +++ b/src/content/docs/terminal/sessions/session-navigation.mdx @@ -3,6 +3,8 @@ title: Session Navigation description: >- Quickly navigate to any terminal session across Warp using the Session Navigation palette. +sidebar: + label: "Session navigation" --- import VideoEmbed from '@components/VideoEmbed.astro'; diff --git a/src/content/docs/terminal/sessions/session-restoration.mdx b/src/content/docs/terminal/sessions/session-restoration.mdx index fe37a6e..b5a131c 100644 --- a/src/content/docs/terminal/sessions/session-restoration.mdx +++ b/src/content/docs/terminal/sessions/session-restoration.mdx @@ -3,6 +3,8 @@ title: Session Restoration description: >- Restore your windows, tabs, panes, and recent Blocks automatically when you relaunch Warp. +sidebar: + label: "Session restoration" --- import DemoVideo from '@components/DemoVideo.astro'; import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/terminal/windows/global-hotkey.mdx b/src/content/docs/terminal/windows/global-hotkey.mdx index 52a8790..49888cf 100644 --- a/src/content/docs/terminal/windows/global-hotkey.mdx +++ b/src/content/docs/terminal/windows/global-hotkey.mdx @@ -3,6 +3,8 @@ title: Global Hotkey description: >- Show or hide Warp instantly with a global hotkey, including a dedicated Quake-style drop-down window. +sidebar: + label: "Global hotkey" --- import DemoVideo from '@components/DemoVideo.astro'; import { Tabs, TabItem } from '@astrojs/starlight/components'; diff --git a/src/content/docs/terminal/windows/vertical-tabs.mdx b/src/content/docs/terminal/windows/vertical-tabs.mdx index b07bf1c..315add8 100644 --- a/src/content/docs/terminal/windows/vertical-tabs.mdx +++ b/src/content/docs/terminal/windows/vertical-tabs.mdx @@ -5,6 +5,8 @@ description: >- The vertical tabs panel replaces the horizontal tab bar with a sidebar showing rich metadata, drag-and-drop management, and display options for tabs and panes. and panes. +sidebar: + label: "Vertical Tabs" --- The vertical tabs panel is a sidebar that replaces the traditional horizontal tab bar with a richer, more powerful tab management surface. Instead of a single row of tab titles, the panel displays every tab and pane with contextual metadata — Git branch, working directory, agent conversation status, diff stats, and more. Scan and switch between workstreams without losing context. From 5ebf297fcc7a01476bc5f2c2d06778a18f898c67 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Mon, 4 May 2026 07:40:05 -1000 Subject: [PATCH 2/8] docs: add 'overview' to H1 titles on section overview pages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Standardize overview page titles to consistently include 'overview' in the H1. Also applies sentence case fixes to these titles. 15 pages updated: - Capabilities → Capabilities overview - Self-hosting → Self-hosting overview - Triggers → Triggers overview - Agent Context → Agent context overview - Third-Party CLI Agents → Third-party CLI agents overview - Cloud Agents Overview → Cloud agents overview (sentence case fix) - Terminal appearance/blocks/completions/comparisons/editor/entry/ more-features/sessions/windows → added 'overview' + sentence case Co-Authored-By: Oz --- src/content/docs/agent-platform/capabilities/index.mdx | 2 +- src/content/docs/agent-platform/cli-agents/overview.mdx | 2 +- src/content/docs/agent-platform/cloud-agents/overview.mdx | 2 +- .../docs/agent-platform/cloud-agents/self-hosting/index.mdx | 2 +- src/content/docs/agent-platform/cloud-agents/triggers/index.mdx | 2 +- .../docs/agent-platform/local-agents/agent-context/index.mdx | 2 +- src/content/docs/terminal/appearance/index.mdx | 2 +- src/content/docs/terminal/blocks/index.mdx | 2 +- src/content/docs/terminal/command-completions/index.mdx | 2 +- src/content/docs/terminal/comparisons/index.mdx | 2 +- src/content/docs/terminal/editor/index.mdx | 2 +- src/content/docs/terminal/entry/index.mdx | 2 +- src/content/docs/terminal/more-features/index.mdx | 2 +- src/content/docs/terminal/sessions/index.mdx | 2 +- src/content/docs/terminal/windows/index.mdx | 2 +- 15 files changed, 15 insertions(+), 15 deletions(-) diff --git a/src/content/docs/agent-platform/capabilities/index.mdx b/src/content/docs/agent-platform/capabilities/index.mdx index 75644d3..242e05b 100644 --- a/src/content/docs/agent-platform/capabilities/index.mdx +++ b/src/content/docs/agent-platform/capabilities/index.mdx @@ -1,5 +1,5 @@ --- -title: Capabilities +title: Capabilities overview description: >- Core capabilities and configuration options that shape how agents behave, what context they have access to, and how they execute tasks. diff --git a/src/content/docs/agent-platform/cli-agents/overview.mdx b/src/content/docs/agent-platform/cli-agents/overview.mdx index 0087b19..84fbfe0 100644 --- a/src/content/docs/agent-platform/cli-agents/overview.mdx +++ b/src/content/docs/agent-platform/cli-agents/overview.mdx @@ -1,5 +1,5 @@ --- -title: Third-Party CLI Agents +title: Third-party CLI agents overview description: >- Warp provides first-class support for third-party CLI coding agents with a rich input editor, notifications, code review, and more. diff --git a/src/content/docs/agent-platform/cloud-agents/overview.mdx b/src/content/docs/agent-platform/cloud-agents/overview.mdx index 559a47c..60b5c94 100644 --- a/src/content/docs/agent-platform/cloud-agents/overview.mdx +++ b/src/content/docs/agent-platform/cloud-agents/overview.mdx @@ -1,5 +1,5 @@ --- -title: Cloud Agents Overview +title: Cloud agents overview description: >- Run background agents in the cloud from events, schedules, or integrations with team-wide observability. diff --git a/src/content/docs/agent-platform/cloud-agents/self-hosting/index.mdx b/src/content/docs/agent-platform/cloud-agents/self-hosting/index.mdx index 21bdeae..453ca10 100644 --- a/src/content/docs/agent-platform/cloud-agents/self-hosting/index.mdx +++ b/src/content/docs/agent-platform/cloud-agents/self-hosting/index.mdx @@ -1,5 +1,5 @@ --- -title: Self-hosting +title: Self-hosting overview description: >- Run Oz cloud agents on your own infrastructure. Choose between a managed worker daemon orchestrated by Oz or unmanaged CLI-based execution you diff --git a/src/content/docs/agent-platform/cloud-agents/triggers/index.mdx b/src/content/docs/agent-platform/cloud-agents/triggers/index.mdx index 6f60e85..84fa965 100644 --- a/src/content/docs/agent-platform/cloud-agents/triggers/index.mdx +++ b/src/content/docs/agent-platform/cloud-agents/triggers/index.mdx @@ -1,5 +1,5 @@ --- -title: Triggers +title: Triggers overview description: >- Configure triggers to run cloud agents automatically based on schedules or events. diff --git a/src/content/docs/agent-platform/local-agents/agent-context/index.mdx b/src/content/docs/agent-platform/local-agents/agent-context/index.mdx index b511fc7..94fdb05 100644 --- a/src/content/docs/agent-platform/local-agents/agent-context/index.mdx +++ b/src/content/docs/agent-platform/local-agents/agent-context/index.mdx @@ -1,5 +1,5 @@ --- -title: Agent Context +title: Agent context overview description: >- How to attach various forms of multi-modal context directly to Warp's Agent within a prompt. diff --git a/src/content/docs/terminal/appearance/index.mdx b/src/content/docs/terminal/appearance/index.mdx index a7b3f3c..8e3d737 100644 --- a/src/content/docs/terminal/appearance/index.mdx +++ b/src/content/docs/terminal/appearance/index.mdx @@ -1,5 +1,5 @@ --- -title: Terminal appearance +title: Terminal appearance overview description: >- Customize Warp's visual appearance, including themes, fonts, prompts, app icons, input position, and pane behavior. diff --git a/src/content/docs/terminal/blocks/index.mdx b/src/content/docs/terminal/blocks/index.mdx index 8ae559e..ba3abd0 100644 --- a/src/content/docs/terminal/blocks/index.mdx +++ b/src/content/docs/terminal/blocks/index.mdx @@ -1,5 +1,5 @@ --- -title: Terminal Blocks +title: Terminal Blocks overview description: >- A Block groups commands and outputs into one atomic unit. --- diff --git a/src/content/docs/terminal/command-completions/index.mdx b/src/content/docs/terminal/command-completions/index.mdx index 4412d25..1be104b 100644 --- a/src/content/docs/terminal/command-completions/index.mdx +++ b/src/content/docs/terminal/command-completions/index.mdx @@ -1,5 +1,5 @@ --- -title: Command Completions +title: Command completions overview description: >- Warp's main features for command completions and autosuggestions. --- diff --git a/src/content/docs/terminal/comparisons/index.mdx b/src/content/docs/terminal/comparisons/index.mdx index cb49a40..16f2210 100644 --- a/src/content/docs/terminal/comparisons/index.mdx +++ b/src/content/docs/terminal/comparisons/index.mdx @@ -1,5 +1,5 @@ --- -title: Terminal comparisons +title: Terminal comparisons overview description: >- Compare Warp's performance and terminal feature support against other popular terminal emulators like iTerm2, Alacritty, and WezTerm. diff --git a/src/content/docs/terminal/editor/index.mdx b/src/content/docs/terminal/editor/index.mdx index 5ad16b8..281cb7c 100644 --- a/src/content/docs/terminal/editor/index.mdx +++ b/src/content/docs/terminal/editor/index.mdx @@ -1,5 +1,5 @@ --- -title: Modern Text Editing +title: Modern text editing overview description: >- Unlike other terminals, Warp’s input editor operates out of the box like a modern IDE and the text editors we’re used to. diff --git a/src/content/docs/terminal/entry/index.mdx b/src/content/docs/terminal/entry/index.mdx index a49419c..28de538 100644 --- a/src/content/docs/terminal/entry/index.mdx +++ b/src/content/docs/terminal/entry/index.mdx @@ -1,5 +1,5 @@ --- -title: Command Entry +title: Command entry overview description: >- Warp's main features for Command Entry, History, Synchronized Inputs, YAML Workflows and More! diff --git a/src/content/docs/terminal/more-features/index.mdx b/src/content/docs/terminal/more-features/index.mdx index 82cb318..aa1c213 100644 --- a/src/content/docs/terminal/more-features/index.mdx +++ b/src/content/docs/terminal/more-features/index.mdx @@ -1,5 +1,5 @@ --- -title: More Features +title: More features overview description: >- Explore additional Warp terminal features beyond the essentials. --- diff --git a/src/content/docs/terminal/sessions/index.mdx b/src/content/docs/terminal/sessions/index.mdx index b0b6d5f..746c27b 100644 --- a/src/content/docs/terminal/sessions/index.mdx +++ b/src/content/docs/terminal/sessions/index.mdx @@ -1,5 +1,5 @@ --- -title: Sessions +title: Sessions overview description: >- Navigate between sessions and automatically restore windows, tabs, and panes when you relaunch Warp. diff --git a/src/content/docs/terminal/windows/index.mdx b/src/content/docs/terminal/windows/index.mdx index b1f8d7b..5494896 100644 --- a/src/content/docs/terminal/windows/index.mdx +++ b/src/content/docs/terminal/windows/index.mdx @@ -1,5 +1,5 @@ --- -title: Windows and Tabs +title: Windows and tabs overview description: >- Manage Warp windows, tabs, vertical tabs, split panes, and tab configurations with global hotkeys and reusable layouts. From a39111991edc3454c5978bee7fda45fe16228802 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Mon, 4 May 2026 07:51:51 -1000 Subject: [PATCH 3/8] fix: remove duplicate description line in supported-shells.mdx Co-Authored-By: Oz --- src/content/docs/getting-started/supported-shells.mdx | 1 - 1 file changed, 1 deletion(-) diff --git a/src/content/docs/getting-started/supported-shells.mdx b/src/content/docs/getting-started/supported-shells.mdx index 5e37dbe..7b0d9ed 100644 --- a/src/content/docs/getting-started/supported-shells.mdx +++ b/src/content/docs/getting-started/supported-shells.mdx @@ -1,7 +1,6 @@ --- title: Supported Shells description: >- - Warp supports bash, zsh, fish, and PowerShell across macOS, Windows, and Warp supports bash, zsh, fish, PowerShell, and WSL2 across macOS, Windows, and Linux. sidebar: From 610b5c59ee4469309b3720d80e6c907902f60743 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Mon, 4 May 2026 08:03:42 -1000 Subject: [PATCH 4/8] fix: remove case-only sidebar.labels and duplicate description - git-worktrees.mdx: remove sidebar.label 'Git Worktrees' (title 'Git worktrees' is already correct sentence case) - vertical-tabs.mdx: remove sidebar.label 'Vertical Tabs' (title 'Vertical tabs' is already correct) and fix duplicate description line Co-Authored-By: Oz --- src/content/docs/code/git-worktrees.mdx | 2 -- src/content/docs/terminal/windows/vertical-tabs.mdx | 5 +---- 2 files changed, 1 insertion(+), 6 deletions(-) diff --git a/src/content/docs/code/git-worktrees.mdx b/src/content/docs/code/git-worktrees.mdx index a9d73fe..60b3645 100644 --- a/src/content/docs/code/git-worktrees.mdx +++ b/src/content/docs/code/git-worktrees.mdx @@ -3,8 +3,6 @@ title: Git worktrees description: >- Warp natively supports Git worktrees, letting you work on multiple branches simultaneously with full Code Review, Codebase Context, and Agent support. -sidebar: - label: "Git Worktrees" --- Warp natively supports [Git worktrees](https://git-scm.com/docs/git-worktree) — a Git feature that lets you check out multiple branches simultaneously in separate directories, all backed by the same repository. This is different from simply switching branches: with worktrees, you can have `~/project` on `main` and `~/project-wt/feature-x` on `feature-x` at the same time, with no stashing or context-switching required. diff --git a/src/content/docs/terminal/windows/vertical-tabs.mdx b/src/content/docs/terminal/windows/vertical-tabs.mdx index 315add8..2f4c786 100644 --- a/src/content/docs/terminal/windows/vertical-tabs.mdx +++ b/src/content/docs/terminal/windows/vertical-tabs.mdx @@ -1,12 +1,9 @@ --- title: Vertical tabs description: >- - The vertical tabs panel replaces Warp's horizontal tab bar with a sidebar The vertical tabs panel replaces the horizontal tab bar with a sidebar showing rich metadata, drag-and-drop management, and display options for - tabs and panes. and panes. -sidebar: - label: "Vertical Tabs" + tabs and panes. --- The vertical tabs panel is a sidebar that replaces the traditional horizontal tab bar with a richer, more powerful tab management surface. Instead of a single row of tab titles, the panel displays every tab and pane with contextual metadata — Git branch, working directory, agent conversation status, diff stats, and more. Scan and switch between workstreams without losing context. From 3e7b8a378a0f9c174abf35f0ecf7010109a19795 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Mon, 4 May 2026 08:06:34 -1000 Subject: [PATCH 5/8] docs: add Vertical Tabs and Tab Configs to terminology glossary - Add 'Vertical Tabs' and 'Tab Configs' as official feature names in .warp/references/terminology.md (Navigation and UI terms section) - Capitalize 'Vertical Tabs' in vertical-tabs.mdx title to match - Restore sidebar.label for Vertical Tabs Co-Authored-By: Oz --- .warp/references/terminology.md | 6 ++++++ src/content/docs/terminal/windows/vertical-tabs.mdx | 4 +++- 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/.warp/references/terminology.md b/.warp/references/terminology.md index 3768d96..aea79cf 100644 --- a/.warp/references/terminology.md +++ b/.warp/references/terminology.md @@ -61,6 +61,12 @@ For the summary of the most critical terms (core features, Oz terms, terms to av - **Tab** / **Pane** / **Window** — Warp's layout primitives: tabs within windows; panes are splits inside a tab/window. *Usage note:* Use precisely to avoid confusing layouts. +- **Tab Configs** — Reusable TOML-based tab layout definitions that launch preconfigured terminal sessions. + *Usage note:* Capitalize as a feature name. + +- **Vertical Tabs** — The sidebar-based tab management panel that replaces the horizontal tab bar. + *Usage note:* Capitalize as a feature name. + ## Agent concepts - **Ambient Agents** — Oz agents that run automatically in the background on a schedule or trigger, without interactive input. diff --git a/src/content/docs/terminal/windows/vertical-tabs.mdx b/src/content/docs/terminal/windows/vertical-tabs.mdx index 2f4c786..0923dc6 100644 --- a/src/content/docs/terminal/windows/vertical-tabs.mdx +++ b/src/content/docs/terminal/windows/vertical-tabs.mdx @@ -1,9 +1,11 @@ --- -title: Vertical tabs +title: Vertical Tabs description: >- The vertical tabs panel replaces the horizontal tab bar with a sidebar showing rich metadata, drag-and-drop management, and display options for tabs and panes. +sidebar: + label: "Vertical Tabs" --- The vertical tabs panel is a sidebar that replaces the traditional horizontal tab bar with a richer, more powerful tab management surface. Instead of a single row of tab titles, the panel displays every tab and pane with contextual metadata — Git branch, working directory, agent conversation status, diff stats, and more. Scan and switch between workstreams without losing context. From 4f4aa28335049ea9acf0ebc49d0e73cd4ba1b0c8 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Mon, 4 May 2026 08:09:49 -1000 Subject: [PATCH 6/8] docs: fix enterprise quickstart title and nav label MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Title: 'Quick start' → 'Enterprise quickstart' (one word per style guide, with descriptive topic name per quickstart rules) - Add sidebar.label: 'Quickstart' for shortened nav display Co-Authored-By: Oz --- src/content/docs/enterprise/getting-started/quickstart.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/content/docs/enterprise/getting-started/quickstart.mdx b/src/content/docs/enterprise/getting-started/quickstart.mdx index 919a366..963e162 100644 --- a/src/content/docs/enterprise/getting-started/quickstart.mdx +++ b/src/content/docs/enterprise/getting-started/quickstart.mdx @@ -1,8 +1,10 @@ --- -title: Quick start +title: Enterprise quickstart description: >- Get up and running with Warp Enterprise in under 10 minutes. Log in, set up your terminal, and run your first Oz agent. +sidebar: + label: "Quickstart" --- This quickstart walks you through the essentials: logging in via SSO, setting up Warp, and running your first Oz agent. You can complete this in under 10 minutes. From 5bd332288e73520e5439f3fc7cd09e764ed2b8fd Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Mon, 4 May 2026 08:16:25 -1000 Subject: [PATCH 7/8] docs: standardize 'quickstart' as one word across all docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fix all instances of 'Quick Start' and 'quick start' to use 'quickstart' (one word, lowercase) per the style guide. Includes: - Cloud agents title: 'Cloud Agents Quick Start' → 'Cloud agents quickstart' - CLI title: 'Quick Start' → 'CLI quickstart' - Section header in command-search.mdx - Body text references in overview, platform, known-issues, integration-setup - Also fixed 'Integrations Overview' → 'Integrations overview' in a link Co-Authored-By: Oz --- scripts/apply-nav-labels.py | 166 ++ scripts/audit-nav-labels.py | 406 +++++ scripts/audit-report.txt | 1564 +++++++++++++++++ .../agent-platform/cloud-agents/overview.mdx | 4 +- .../agent-platform/cloud-agents/platform.mdx | 2 +- .../cloud-agents/quickstart.mdx | 4 +- src/content/docs/reference/cli/index.mdx | 2 +- .../docs/reference/cli/integration-setup.mdx | 2 +- src/content/docs/reference/cli/quickstart.mdx | 2 +- .../known-issues.mdx | 2 +- .../docs/terminal/entry/command-search.mdx | 2 +- 11 files changed, 2146 insertions(+), 10 deletions(-) create mode 100644 scripts/apply-nav-labels.py create mode 100644 scripts/audit-nav-labels.py create mode 100644 scripts/audit-report.txt diff --git a/scripts/apply-nav-labels.py b/scripts/apply-nav-labels.py new file mode 100644 index 0000000..4048abf --- /dev/null +++ b/scripts/apply-nav-labels.py @@ -0,0 +1,166 @@ +#!/usr/bin/env python3 +"""Apply nav label fixes from curated audit-report.txt. + +Parses the human-reviewed audit report and applies: +1. Missing nav labels (section 1) — adds sidebar.label to frontmatter +2. Nav label sentence case fixes (section 3) — adds/updates sidebar.label + +Skips: +- Error pages in reference/api-and-sdk/troubleshooting/errors/ +- sidebar.ts overrides (those entries are left as-is) + +Usage: + python3 scripts/apply-nav-labels.py # dry run + python3 scripts/apply-nav-labels.py --apply # apply changes +""" + +import re +import sys +from pathlib import Path + +DOCS_REPO = Path(__file__).resolve().parent.parent +REPORT_PATH = DOCS_REPO / "scripts" / "audit-report.txt" +CONTENT_ROOT = DOCS_REPO / "src" / "content" / "docs" + +# Skip error code pages (intentionally lowercase) +SKIP_PATTERNS = [ + "reference/api-and-sdk/troubleshooting/errors/", +] + + +def parse_report(): + """Parse the curated audit-report.txt into a dict of {file_path: label}.""" + changes = {} # relative_path -> sidebar_label + + with open(REPORT_PATH) as f: + content = f.read() + + # Section 1: MISSING NAV LABELS + # Pattern: lines like '→ Add sidebar.label: "Some label"' + # preceded by file path lines + section1_match = re.search( + r'## MISSING NAV LABELS.*?\n(.*?)(?=\n## TITLE SENTENCE CASE)', + content, re.DOTALL + ) + if section1_match: + block = section1_match.group(1) + # Parse file + label pairs + entries = re.findall( + r'^\s+(src/content/docs/\S+)\s*\n' + r'.*?\n.*?\n' + r'\s+→ Add sidebar\.label: "([^"]+)"', + block, re.MULTILINE + ) + for filepath, label in entries: + if not any(skip in filepath for skip in SKIP_PATTERNS): + changes[filepath] = label + + # Section 3: NAV LABEL SENTENCE CASE ISSUES + # Pattern: file path, then "Current (source): ...", then "Suggested: ..." + section3_match = re.search( + r'## NAV LABEL SENTENCE CASE ISSUES.*?\n(.*?)(?=\n={5,})', + content, re.DOTALL + ) + if section3_match: + block = section3_match.group(1) + entries = re.findall( + r'^\s+(src/content/docs/\S+)\s*\n' + r'\s+Current \(([^)]+)\):.*?\n' + r'\s+Suggested: (.+)', + block, re.MULTILINE + ) + for filepath, source, suggested in entries: + suggested = suggested.strip() + # Skip sidebar.ts entries (we don't modify sidebar.ts) + if source == "sidebar.ts": + continue + # Skip error pages + if any(skip in filepath for skip in SKIP_PATTERNS): + continue + # Don't overwrite section 1 entries (they were reviewed first) + if filepath not in changes: + changes[filepath] = suggested + + return changes + + +def apply_sidebar_label(mdx_path, label): + """Add or update sidebar.label in an MDX file's frontmatter.""" + content = mdx_path.read_text() + + # Find frontmatter bounds + fm_match = re.match(r'^(---\s*\n)(.*?\n)(---)', content, re.DOTALL) + if not fm_match: + return False + + fm_text = fm_match.group(2) + fm_start = fm_match.start(2) + fm_end = fm_match.end(2) + + # Case 1: sidebar.label already exists — update it + # Use [ \t]* instead of \s* to avoid consuming newlines + existing = re.search( + r'^(\s+label:\s*)["\']?.*?["\']?[ \t]*$', + fm_text, re.MULTILINE + ) + if existing and 'sidebar:' in fm_text: + new_fm = fm_text[:existing.start()] + f' label: "{label}"' + fm_text[existing.end():] + new_content = content[:fm_start] + new_fm + content[fm_end:] + mdx_path.write_text(new_content) + return True + + # Case 2: sidebar: block exists but no label + sidebar_match = re.search(r'^sidebar:\s*$', fm_text, re.MULTILINE) + if sidebar_match: + insert_pos = sidebar_match.end() + new_fm = fm_text[:insert_pos] + f'\n label: "{label}"' + fm_text[insert_pos:] + new_content = content[:fm_start] + new_fm + content[fm_end:] + mdx_path.write_text(new_content) + return True + + # Case 3: No sidebar block — add before closing --- + new_fm = fm_text.rstrip('\n') + f'\nsidebar:\n label: "{label}"\n' + new_content = content[:fm_start] + new_fm + content[fm_end:] + mdx_path.write_text(new_content) + return True + + +def main(): + dry_run = "--apply" not in sys.argv + + if dry_run: + print("DRY RUN — pass --apply to make changes\n") + + changes = parse_report() + print(f"Found {len(changes)} nav label changes to apply.\n") + + applied = 0 + skipped = 0 + for rel_path, label in sorted(changes.items()): + mdx_path = DOCS_REPO / rel_path + if not mdx_path.exists(): + print(f" SKIP (not found): {rel_path}") + skipped += 1 + continue + + print(f" {rel_path}") + print(f" sidebar.label: \"{label}\"") + + if not dry_run: + if apply_sidebar_label(mdx_path, label): + print(f" ✓ applied") + applied += 1 + else: + print(f" ⚠ failed (no frontmatter?)") + skipped += 1 + else: + applied += 1 + + print() + + action = "Would apply" if dry_run else "Applied" + print(f"\n{action}: {applied} | Skipped: {skipped}") + + +if __name__ == "__main__": + main() diff --git a/scripts/audit-nav-labels.py b/scripts/audit-nav-labels.py new file mode 100644 index 0000000..7221525 --- /dev/null +++ b/scripts/audit-nav-labels.py @@ -0,0 +1,406 @@ +#!/usr/bin/env python3 +"""Audit nav labels and sentence case across docs. + +Compares GitBook SUMMARY.md nav labels against Astro frontmatter titles, +identifies pages that need sidebar.label overrides, and flags sentence case +issues in titles and existing labels. + +Usage: + python3 scripts/audit-nav-labels.py +""" + +import os +import re +import sys +import yaml +from pathlib import Path +from typing import Dict, Optional + +# --------------------------------------------------------------------------- +# Configuration +# --------------------------------------------------------------------------- + +DOCS_REPO = Path(__file__).resolve().parent.parent +GITBOOK_REPO = Path.home() / "Documents" / "Warp" / "gitbook" +ASTRO_CONTENT = DOCS_REPO / "src" / "content" / "docs" + +# GitBook spaces and their corresponding Astro prefixes +GITBOOK_SPACES = { + "docs/warp": "", # maps to root-level dirs in Astro + "docs/agent-platform": "agent-platform", + "docs/reference": "reference", + "docs/support-and-community": "support-and-community", + "docs/enterprise": "enterprise", + "docs/changelog": "changelog", +} + +# Proper nouns that retain capitalization (from terminology.md) +# These are matched case-insensitively and restored to their canonical form. +PROPER_NOUNS = [ + # Multi-word first (order matters for replacement) + "Agent Management Panel", "Agent Mode", "Agent Profiles", + "Auto-detection Mode", "Terminal Mode", "Universal Input", + "Warp Drive", "Admin Panel", "Command Palette", + "Codebase Context", "Code Review", "Ambient Agents", + "Slash Commands", "Environment Variables", "Environment Variable", + "Cloud Agent Credits", "Add-on Credits", + "Oz cloud agent", "Oz web app", "Oz dashboard", + "Oz subagent", "Oz agent", "Oz conversation", "Oz run", + "GitHub Actions", "GitHub App", "Claude Code", + "AGPL v3", "Azure DevOps", "Windows Terminal", "VS Code", + "Google Cloud", + # Single-word proper nouns + "Warp", "Oz", "Warpify", "Agent", "Agents", "Block", "Blocks", + "Settings", "Rules", "Notebooks", "Notebook", + "Workflows", "Workflow", "Prompts", "Prompt", + "GitHub", "Linear", "Slack", "Codex", "Gemini", "OpenCode", + "Git", "Vim", "Docker", "Kubernetes", "Vercel", "Figma", + "Sentry", "Puppeteer", "Ollama", "Railway", "Bitbucket", "GitLab", + # External product names (not in terminology.md but still proper nouns) + "Linux", "Windows", "Chrome", "Cursor", "Ghostty", "iTerm2", + "Postgres", "PostgreSQL", "Astro", "Tailwind", "React", + "TypeScript", "JavaScript", "Slackbot", "DevOps", + "Helm", "Stripe", "SQLite", "Amazon", "Context7", + # Acronyms / always-caps + "MCP", "SSH", "LSP", "CLI", "API", "SDK", "SSO", "FAQ", "FAQs", + "UI", "URI", "GCP", "SQL", "PR", "PRs", "DNS", "CSS", "HTML", + "JSON", "YAML", "AI", "LLM", "REPL", "YOLO", + # Special casing + "macOS", "D3.js", "gcloud", +] + +# Build a lookup: lowercase -> canonical form +PROPER_NOUN_MAP = {} +for noun in PROPER_NOUNS: + PROPER_NOUN_MAP[noun.lower()] = noun + + +# --------------------------------------------------------------------------- +# Parsing helpers +# --------------------------------------------------------------------------- + +def parse_summary_md(path: Path) -> Dict[str, str]: + """Parse a GitBook SUMMARY.md and return {relative_path: nav_label}. + + GitBook format: + * [Link Text](path/to/file.md) -> nav label = "Link Text" + * [Link Text](path/to/file.md "Override") -> nav label = "Override" + """ + entries = {} + if not path.exists(): + return entries + + pattern = re.compile( + r'\*\s+\[([^\]]+)\]' # [Link Text] + r'\(([^)"\s]+)' # (path + r'(?:\s+"([^"]+)")?' # optional "Override" + r'\)' # ) + ) + + with open(path) as f: + for line in f: + m = pattern.search(line) + if m: + link_text = m.group(1).strip() + file_path = m.group(2).strip() + override = m.group(3) + nav_label = override.strip() if override else link_text + entries[file_path] = nav_label + + return entries + + +def gitbook_path_to_astro(gitbook_path: str, space_prefix: str) -> Optional[Path]: + """Map a GitBook file path to an Astro MDX file path.""" + # README.md -> index.mdx + if gitbook_path.endswith("README.md"): + astro_path = gitbook_path.replace("README.md", "index.mdx") + else: + astro_path = gitbook_path.replace(".md", ".mdx") + + if space_prefix: + full_path = ASTRO_CONTENT / space_prefix / astro_path + else: + full_path = ASTRO_CONTENT / astro_path + + if full_path.exists(): + return full_path + + # Try without the space prefix mapping for warp/ space which maps to + # multiple top-level dirs + if not space_prefix: + # The warp space files map directly (terminal/, code/, etc.) + return full_path if full_path.exists() else None + + return None + + +def extract_frontmatter(path: Path) -> dict: + """Extract YAML frontmatter from an MDX file.""" + with open(path) as f: + content = f.read() + + match = re.match(r'^---\s*\n(.*?)\n---', content, re.DOTALL) + if not match: + return {} + + try: + return yaml.safe_load(match.group(1)) or {} + except yaml.YAMLError: + return {} + + +def to_sentence_case(text: str) -> str: + """Convert text to sentence case, preserving proper nouns. + + Strategy: work word-by-word. For each word (or multi-word proper noun), + check if it matches a known proper noun. If so, use the canonical form. + Otherwise, lowercase it (except the very first word gets capitalized). + """ + if not text: + return text + + # Build a set of multi-word proper nouns for phrase matching + sorted_nouns = sorted(PROPER_NOUNS, key=len, reverse=True) + + # Step 1: Protect proper nouns by replacing with indexed placeholders. + # Use § markers that won't appear in real text. + protected = [] # list of (placeholder, canonical) + working = text + + for noun in sorted_nouns: + pattern = re.compile(r'\b' + re.escape(noun) + r'\b', re.IGNORECASE) + # Find all matches but only replace if the match is clean + while True: + m = pattern.search(working) + if not m: + break + idx = len(protected) + placeholder = f"§{idx}§" + canonical = PROPER_NOUN_MAP[noun.lower()] + protected.append((placeholder, canonical)) + working = working[:m.start()] + placeholder + working[m.end():] + + # Step 2: Apply sentence case to the remaining (non-proper-noun) text. + # Split on placeholders to process only the plain-text segments. + # Tokenize: split into segments of [text, placeholder, text, placeholder, ...] + parts = re.split(r'(§\d+§)', working) + + first_alpha_done = False + result_parts = [] + for part in parts: + if re.match(r'^§\d+§$', part): + # This is a placeholder — check if it's the first alphabetic content + if not first_alpha_done: + first_alpha_done = True + result_parts.append(part) + else: + # Plain text — lowercase it + lowered = part.lower() + if not first_alpha_done: + # Capitalize the first alpha char in the entire string + chars = list(lowered) + for i, ch in enumerate(chars): + if ch.isalpha(): + chars[i] = ch.upper() + first_alpha_done = True + break + lowered = ''.join(chars) + result_parts.append(lowered) + + result = ''.join(result_parts) + + # Step 3: Restore proper nouns + for placeholder, canonical in protected: + result = result.replace(placeholder, canonical) + + return result + + +def has_sentence_case_issues(text: str) -> bool: + """Check if text has sentence case issues.""" + if not text: + return False + corrected = to_sentence_case(text) + return corrected != text + + +# --------------------------------------------------------------------------- +# Sidebar.ts label parsing +# --------------------------------------------------------------------------- + +def parse_sidebar_ts_labels() -> Dict[str, str]: + """Parse sidebar.ts to find { slug, label } overrides.""" + sidebar_path = DOCS_REPO / "src" / "sidebar.ts" + labels = {} + + if not sidebar_path.exists(): + return labels + + with open(sidebar_path) as f: + content = f.read() + + # Match patterns like: { slug: 'terminal/blocks', label: 'Overview' } + pattern = re.compile( + r"slug:\s*'([^']+)'\s*,\s*label:\s*'([^']+)'" + ) + for m in pattern.finditer(content): + labels[m.group(1)] = m.group(2) + + return labels + + +# --------------------------------------------------------------------------- +# Main audit +# --------------------------------------------------------------------------- + +def run_audit(): + issues = [] + info_rows = [] + + # Load sidebar.ts overrides + sidebar_ts_labels = parse_sidebar_ts_labels() + + # Parse all GitBook SUMMARY.md files + gitbook_nav: Dict[str, dict] = {} # astro_path -> {gitbook_label, gitbook_space} + + for space, prefix in GITBOOK_SPACES.items(): + summary_path = GITBOOK_REPO / space / "SUMMARY.md" + entries = parse_summary_md(summary_path) + + for gb_path, nav_label in entries.items(): + astro_path = gitbook_path_to_astro(gb_path, prefix) + if astro_path: + gitbook_nav[str(astro_path)] = { + "label": nav_label, + "space": space, + } + + # Scan all Astro MDX files + all_mdx = sorted(ASTRO_CONTENT.rglob("*.mdx")) + + for mdx_path in all_mdx: + fm = extract_frontmatter(mdx_path) + title = fm.get("title", "") + sidebar = fm.get("sidebar", {}) or {} + sidebar_label = sidebar.get("label", "") if isinstance(sidebar, dict) else "" + + # Determine the slug for sidebar.ts lookup + rel = mdx_path.relative_to(ASTRO_CONTENT) + slug = str(rel).replace("/index.mdx", "").replace(".mdx", "") + if slug == "index": + slug = "index" + + sidebar_ts_label = sidebar_ts_labels.get(slug, "") + + # Effective nav label (what actually shows in the sidebar) + if sidebar_ts_label: + effective_label = sidebar_ts_label + label_source = "sidebar.ts" + elif sidebar_label: + effective_label = sidebar_label + label_source = "frontmatter" + else: + effective_label = title + label_source = "title (fallback)" + + # GitBook nav label + gb_info = gitbook_nav.get(str(mdx_path)) + gb_label = gb_info["label"] if gb_info else "" + + rel_display = str(mdx_path.relative_to(DOCS_REPO)) + + # Check 1: Missing nav label override (GitBook had shorter label) + needs_label = False + recommended_label = "" + if gb_label and gb_label != title and label_source == "title (fallback)": + # GitBook had a different (usually shorter) label than the current title + needs_label = True + recommended_label = gb_label + + # Check 2: Sentence case issues in title + title_case_issue = has_sentence_case_issues(title) + corrected_title = to_sentence_case(title) if title_case_issue else "" + + # Check 3: Sentence case issues in effective nav label + label_case_issue = has_sentence_case_issues(effective_label) + corrected_label = to_sentence_case(effective_label) if label_case_issue else "" + + has_any_issue = needs_label or title_case_issue or label_case_issue + + if has_any_issue: + issue = { + "file": rel_display, + "title": title, + "effective_label": effective_label, + "label_source": label_source, + "gb_label": gb_label, + "needs_label": needs_label, + "recommended_label": recommended_label, + "title_case_issue": title_case_issue, + "corrected_title": corrected_title, + "label_case_issue": label_case_issue, + "corrected_label": corrected_label, + } + issues.append(issue) + + # Print report + print("=" * 80) + print("NAV LABEL & SENTENCE CASE AUDIT REPORT") + print("=" * 80) + + # Section 1: Missing nav label overrides + missing = [i for i in issues if i["needs_label"]] + print(f"\n## MISSING NAV LABELS ({len(missing)} pages)") + print("These pages had shorter nav labels in GitBook that weren't migrated.\n") + for i in missing: + print(f" {i['file']}") + print(f" Title (H1): {i['title']}") + print(f" GitBook nav label: {i['gb_label']}") + print(f" → Add sidebar.label: \"{i['recommended_label']}\"") + print() + + # Section 2: Sentence case issues in titles + title_issues = [i for i in issues if i["title_case_issue"]] + print(f"\n## TITLE SENTENCE CASE ISSUES ({len(title_issues)} pages)") + print("These titles don't follow sentence case rules.\n") + for i in title_issues: + print(f" {i['file']}") + print(f" Current: {i['title']}") + print(f" Suggested: {i['corrected_title']}") + print() + + # Section 3: Sentence case issues in nav labels + label_issues = [i for i in issues if i["label_case_issue"]] + print(f"\n## NAV LABEL SENTENCE CASE ISSUES ({len(label_issues)} pages)") + print("These nav labels don't follow sentence case rules.\n") + for i in label_issues: + print(f" {i['file']}") + print(f" Current ({i['label_source']}): {i['effective_label']}") + print(f" Suggested: {i['corrected_label']}") + print() + + # Summary + print("=" * 80) + print("SUMMARY") + print(f" Missing nav labels: {len(missing)}") + print(f" Title sentence case issues: {len(title_issues)}") + print(f" Label sentence case issues: {len(label_issues)}") + print(f" Total pages with issues: {len(issues)}") + print(f" Total pages scanned: {len(all_mdx)}") + print("=" * 80) + + return len(issues) + + +if __name__ == "__main__": + try: + import yaml + except ImportError: + print("Installing PyYAML...") + import subprocess + subprocess.check_call([sys.executable, "-m", "pip", "install", "pyyaml"]) + import yaml + + count = run_audit() + sys.exit(0 if count == 0 else 1) diff --git a/scripts/audit-report.txt b/scripts/audit-report.txt new file mode 100644 index 0000000..9ef900d --- /dev/null +++ b/scripts/audit-report.txt @@ -0,0 +1,1564 @@ +================================================================================ +NAV LABEL & SENTENCE CASE AUDIT REPORT +================================================================================ + +## MISSING NAV LABELS (97 pages) +These pages had shorter nav labels in GitBook that weren't migrated. + + src/content/docs/agent-platform/cli-agents/overview.mdx + Title (H1): Third-Party CLI Agents + GitBook nav label: Overview + → Add sidebar.label: "Overview" + + src/content/docs/agent-platform/cloud-agents/deployment-patterns.mdx + Title (H1): Deployment Patterns + GitBook nav label: Deployment patterns + → Add sidebar.label: "Deployment patterns" + + src/content/docs/agent-platform/cloud-agents/faqs.mdx + Title (H1): Cloud Agent FAQs + GitBook nav label: Cloud agent FAQs + → Add sidebar.label: "Cloud agent FAQs" + + src/content/docs/agent-platform/cloud-agents/integrations/cloud-providers.mdx + Title (H1): Cloud Providers (Preview) + GitBook nav label: AWS, GCP, and other cloud providers + → Add sidebar.label: "AWS, GCP, and other cloud providers" + + src/content/docs/agent-platform/cloud-agents/integrations/demo-issue-triage-bot.mdx + Title (H1): Demo: Issue Triage Bot + GitBook nav label: Demo: Issue triage bot + → Add sidebar.label: "Demo: Issue triage bot" + + src/content/docs/agent-platform/cloud-agents/integrations/quickstart-github-actions.mdx + Title (H1): GitHub Actions quickstart + GitBook nav label: Quickstart + → Add sidebar.label: "Quickstart" + + src/content/docs/agent-platform/cloud-agents/integrations/quickstart.mdx + Title (H1): Integrations quickstart + GitBook nav label: Quickstart + → Add sidebar.label: "Quickstart" + + src/content/docs/agent-platform/cloud-agents/managing-cloud-agents.mdx + Title (H1): Managing Cloud Agents + GitBook nav label: Managing cloud agents + → Add sidebar.label: "Managing cloud agents" + + src/content/docs/agent-platform/cloud-agents/mcp.mdx + Title (H1): MCP Servers + GitBook nav label: MCP servers + → Add sidebar.label: "MCP servers" + + src/content/docs/agent-platform/cloud-agents/overview.mdx + Title (H1): Cloud Agents Overview + GitBook nav label: Cloud agents overview + → Add sidebar.label: "Cloud agents overview" + + src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx + Title (H1): Oz Web App + GitBook nav label: Oz web app + → Add sidebar.label: "Oz web app" + + src/content/docs/agent-platform/cloud-agents/platform.mdx + Title (H1): Oz Platform + GitBook nav label: Oz platform + → Add sidebar.label: "Oz platform" + + src/content/docs/agent-platform/cloud-agents/quickstart.mdx + Title (H1): Cloud Agents Quick Start + GitBook nav label: Quickstart + → Add sidebar.label: "Quickstart" + + src/content/docs/agent-platform/cloud-agents/self-hosting/managed-direct.mdx + Title (H1): Managed: Direct backend + GitBook nav label: Managed: Direct + → Add sidebar.label: "Managed: Direct" + + src/content/docs/agent-platform/cloud-agents/self-hosting/managed-docker.mdx + Title (H1): Managed: Docker backend + GitBook nav label: Managed: Docker + → Add sidebar.label: "Managed: Docker" + + src/content/docs/agent-platform/cloud-agents/self-hosting/managed-kubernetes.mdx + Title (H1): Managed: Kubernetes backend + GitBook nav label: Managed: Kubernetes + → Add sidebar.label: "Managed: Kubernetes" + + src/content/docs/agent-platform/cloud-agents/self-hosting/quickstart.mdx + Title (H1): Self-hosting quickstart + GitBook nav label: Quickstart + → Add sidebar.label: "Quickstart" + + src/content/docs/agent-platform/cloud-agents/self-hosting/troubleshooting.mdx + Title (H1): Self-hosting troubleshooting + GitBook nav label: Troubleshooting + → Add sidebar.label: "Troubleshooting" + + src/content/docs/agent-platform/cloud-agents/self-hosting/unmanaged.mdx + Title (H1): Unmanaged architecture + GitBook nav label: Unmanaged + → Add sidebar.label: "Unmanaged" + + src/content/docs/agent-platform/cloud-agents/skills-as-agents.mdx + Title (H1): Skills as Agents + GitBook nav label: Skills as agents + → Add sidebar.label: "Skills as agents" + + src/content/docs/agent-platform/cloud-agents/team-access-billing-and-identity.mdx + Title (H1): Access, billing, and identity permissions + GitBook nav label: Access, billing, and identity + → Add sidebar.label: "Access, billing, and identity" + + src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents-quickstart.mdx + Title (H1): Scheduled Agents quickstart + GitBook nav label: Quickstart + → Add sidebar.label: "Quickstart" + + src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents.mdx + Title (H1): Scheduled Agents + GitBook nav label: Scheduled agents + → Add sidebar.label: "Scheduled agents" + + src/content/docs/agent-platform/cloud-agents/viewing-cloud-agent-runs.mdx + Title (H1): Cloud agent session sharing + GitBook nav label: Viewing cloud agent runs + → Add sidebar.label: "Viewing cloud agent runs" + + src/content/docs/code/code-editor/code-editor-vim-keybindings.mdx + Title (H1): Code Editor Vim Keybindings + GitBook nav label: Code editor Vim keybindings + → Add sidebar.label: "Code editor Vim keybindings" + + src/content/docs/code/code-editor/find-and-replace.mdx + Title (H1): Find and Replace + GitBook nav label: Find & replace + → Add sidebar.label: "Find & replace" + + src/content/docs/code/git-worktrees.mdx + Title (H1): Git worktrees + GitBook nav label: Git Worktrees + → Add sidebar.label: "Git Worktrees" + + src/content/docs/enterprise/getting-started/getting-started-enterprise.mdx + Title (H1): Getting started with Warp Enterprise + GitBook nav label: Getting started for admins + → Add sidebar.label: "Getting started for admins" + + src/content/docs/enterprise/team-management/admin-panel.mdx + Title (H1): Admin Panel + GitBook nav label: Admin panel + → Add sidebar.label: "Admin panel" + + src/content/docs/getting-started/keyboard-shortcuts.mdx + Title (H1): Keyboard Shortcuts + GitBook nav label: Keyboard shortcuts + → Add sidebar.label: "Keyboard shortcuts" + + src/content/docs/getting-started/supported-shells.mdx + Title (H1): Supported Shells + GitBook nav label: Supported shells + → Add sidebar.label: "Supported shells" + + src/content/docs/knowledge-and-collaboration/warp-drive/agent-mode-context.mdx + Title (H1): Agent Mode Context + GitBook nav label: Agent Mode context + → Add sidebar.label: "Agent Mode context" + + src/content/docs/knowledge-and-collaboration/warp-drive/notebooks.mdx + Title (H1): Warp Drive Notebooks + GitBook nav label: Notebooks + → Add sidebar.label: "Notebooks" + + src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx + Title (H1): Warp Drive prompts + GitBook nav label: Prompts + → Add sidebar.label: "Prompts" + + src/content/docs/knowledge-and-collaboration/warp-drive/workflows.mdx + Title (H1): Warp Drive Workflows + GitBook nav label: Workflows + → Add sidebar.label: "Workflows" + + src/content/docs/reference/api-and-sdk/quickstart.mdx + Title (H1): API & SDK quickstart + GitBook nav label: Quickstart + → Add sidebar.label: "Quickstart" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/authentication-required.mdx + Title (H1): authentication_required + GitBook nav label: authentication\_required + → Add sidebar.label: "authentication\_required" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/budget-exceeded.mdx + Title (H1): budget_exceeded + GitBook nav label: budget\_exceeded + → Add sidebar.label: "budget\_exceeded" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/content-policy-violation.mdx + Title (H1): content_policy_violation + GitBook nav label: content\_policy\_violation + → Add sidebar.label: "content\_policy\_violation" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/environment-setup-failed.mdx + Title (H1): environment_setup_failed + GitBook nav label: environment\_setup\_failed + → Add sidebar.label: "environment\_setup\_failed" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/external-authentication-required.mdx + Title (H1): external_authentication_required + GitBook nav label: external\_authentication\_required + → Add sidebar.label: "external\_authentication\_required" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/feature-not-available.mdx + Title (H1): feature_not_available + GitBook nav label: feature\_not\_available + → Add sidebar.label: "feature\_not\_available" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/insufficient-credits.mdx + Title (H1): insufficient_credits + GitBook nav label: insufficient\_credits + → Add sidebar.label: "insufficient\_credits" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/integration-disabled.mdx + Title (H1): integration_disabled + GitBook nav label: integration\_disabled + → Add sidebar.label: "integration\_disabled" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/integration-not-configured.mdx + Title (H1): integration_not_configured + GitBook nav label: integration\_not\_configured + → Add sidebar.label: "integration\_not\_configured" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/internal-error.mdx + Title (H1): internal_error + GitBook nav label: internal\_error + → Add sidebar.label: "internal\_error" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/invalid-request.mdx + Title (H1): invalid_request + GitBook nav label: invalid\_request + → Add sidebar.label: "invalid\_request" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/not-authorized.mdx + Title (H1): not_authorized + GitBook nav label: not\_authorized + → Add sidebar.label: "not\_authorized" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/operation-not-supported.mdx + Title (H1): operation_not_supported + GitBook nav label: operation\_not\_supported + → Add sidebar.label: "operation\_not\_supported" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/resource-not-found.mdx + Title (H1): resource_not_found + GitBook nav label: resource\_not\_found + → Add sidebar.label: "resource\_not\_found" + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/resource-unavailable.mdx + Title (H1): resource_unavailable + GitBook nav label: resource\_unavailable + → Add sidebar.label: "resource\_unavailable" + + src/content/docs/reference/cli/agent-profiles.mdx + Title (H1): Agent profiles + GitBook nav label: Agent Profiles + → Add sidebar.label: "Agent Profiles" + + src/content/docs/reference/cli/api-keys.mdx + Title (H1): API keys + GitBook nav label: API Keys + → Add sidebar.label: "API Keys" + + src/content/docs/reference/cli/integration-setup.mdx + Title (H1): Integration setup + GitBook nav label: Integration Setup + → Add sidebar.label: "Integration Setup" + + src/content/docs/reference/cli/mcp-servers.mdx + Title (H1): MCP servers + GitBook nav label: MCP Servers + → Add sidebar.label: "MCP Servers" + + src/content/docs/reference/cli/quickstart.mdx + Title (H1): Quick Start + GitBook nav label: Quickstart + → Add sidebar.label: "Quickstart" + + src/content/docs/reference/cli/skills.mdx + Title (H1): Skills (CLI) + GitBook nav label: Skills + → Add sidebar.label: "Skills" + + src/content/docs/reference/cli/warp-drive.mdx + Title (H1): Warp Drive context + GitBook nav label: Warp Drive Context + → Add sidebar.label: "Warp Drive Context" + + src/content/docs/support-and-community/community/open-source-licenses.mdx + Title (H1): Open source licenses + GitBook nav label: Open Source Licenses + → Add sidebar.label: "Open Source Licenses" + + src/content/docs/support-and-community/community/refer-a-friend.mdx + Title (H1): Refer a friend and earn rewards + GitBook nav label: Refer a Friend & Earn Rewards + → Add sidebar.label: "Refer a Friend & Earn Rewards" + + src/content/docs/support-and-community/plans-and-billing/plans-pricing-refunds.mdx + Title (H1): Plans, pricing, and refunds + GitBook nav label: Plans, Pricing, & Refunds + → Add sidebar.label: "Plans, Pricing, & Refunds" + + src/content/docs/support-and-community/troubleshooting-and-support/logging-out-and-uninstalling.mdx + Title (H1): Logging out & uninstalling + GitBook nav label: Logging Out & Uninstalling + → Add sidebar.label: "Logging Out & Uninstalling" + + src/content/docs/support-and-community/troubleshooting-and-support/sending-us-feedback.mdx + Title (H1): Sending feedback and logs + GitBook nav label: Sending Feedback & Logs + → Add sidebar.label: "Sending Feedback & Logs" + + src/content/docs/terminal/appearance/blocks-behavior.mdx + Title (H1): Blocks Behavior + GitBook nav label: Blocks behavior + → Add sidebar.label: "Blocks behavior" + + src/content/docs/terminal/appearance/custom-themes.mdx + Title (H1): Custom Themes + GitBook nav label: Custom themes + → Add sidebar.label: "Custom themes" + + src/content/docs/terminal/appearance/pane-dimming.mdx + Title (H1): Pane Dimming & Focus + GitBook nav label: Pane dimming & focus + → Add sidebar.label: "Pane dimming & focus" + + src/content/docs/terminal/appearance/prompt.mdx + Title (H1): Terminal prompt + GitBook nav label: Prompt + → Add sidebar.label: "Prompt" + + src/content/docs/terminal/appearance/size-opacity-blurring.mdx + Title (H1): Size, Opacity, & Blurring + GitBook nav label: Size, opacity, & blurring + → Add sidebar.label: "Size, opacity, & blurring" + + src/content/docs/terminal/appearance/tabs-behavior.mdx + Title (H1): Tabs Behavior + GitBook nav label: Tabs behavior + → Add sidebar.label: "Tabs behavior" + + src/content/docs/terminal/appearance/text-fonts-cursor.mdx + Title (H1): Text, Fonts, & Cursor + GitBook nav label: Text, fonts, & cursor + → Add sidebar.label: "Text, fonts, & cursor" + + src/content/docs/terminal/appearance/themes.mdx + Title (H1): Terminal themes + GitBook nav label: Themes + → Add sidebar.label: "Themes" + + src/content/docs/terminal/blocks/background-blocks.mdx + Title (H1): Background Blocks + GitBook nav label: Background blocks + → Add sidebar.label: "Background blocks" + + src/content/docs/terminal/blocks/block-actions.mdx + Title (H1): Block Actions + GitBook nav label: Block actions + → Add sidebar.label: "Block actions" + + src/content/docs/terminal/blocks/block-basics.mdx + Title (H1): Terminal Block Basics + GitBook nav label: Block basics + → Add sidebar.label: "Block basics" + + src/content/docs/terminal/blocks/block-filtering.mdx + Title (H1): Block Filtering + GitBook nav label: Block filtering + → Add sidebar.label: "Block filtering" + + src/content/docs/terminal/blocks/block-sharing.mdx + Title (H1): Block Sharing + GitBook nav label: Block sharing + → Add sidebar.label: "Block sharing" + + src/content/docs/terminal/blocks/find.mdx + Title (H1): Terminal Block Find + GitBook nav label: Block find + → Add sidebar.label: "Block find" + + src/content/docs/terminal/editor/alias-expansion.mdx + Title (H1): Alias Expansion + GitBook nav label: Alias expansion + → Add sidebar.label: "Alias expansion" + + src/content/docs/terminal/editor/command-inspector.mdx + Title (H1): Command Inspector + GitBook nav label: Command inspector + → Add sidebar.label: "Command inspector" + + src/content/docs/terminal/editor/syntax-error-highlighting.mdx + Title (H1): Syntax & Error Highlighting + GitBook nav label: Syntax & error highlighting + → Add sidebar.label: "Syntax & error highlighting" + + src/content/docs/terminal/editor/vim.mdx + Title (H1): Input editor Vim keybindings + GitBook nav label: Vim keybindings + → Add sidebar.label: "Vim keybindings" + + src/content/docs/terminal/entry/command-corrections.mdx + Title (H1): Command Corrections + GitBook nav label: Command corrections + → Add sidebar.label: "Command corrections" + + src/content/docs/terminal/entry/command-history.mdx + Title (H1): Command History + GitBook nav label: Command history + → Add sidebar.label: "Command history" + + src/content/docs/terminal/entry/command-search.mdx + Title (H1): Command Search + GitBook nav label: Command search + → Add sidebar.label: "Command search" + + src/content/docs/terminal/entry/synchronized-inputs.mdx + Title (H1): Synchronized Inputs + GitBook nav label: Synchronized inputs + → Add sidebar.label: "Synchronized inputs" + + src/content/docs/terminal/entry/yaml-workflows.mdx + Title (H1): YAML Workflows + GitBook nav label: YAML workflows + → Add sidebar.label: "YAML workflows" + + src/content/docs/terminal/integrations-and-plugins.mdx + Title (H1): Terminal Integrations + GitBook nav label: Terminal integrations + → Add sidebar.label: "Terminal integrations" + + src/content/docs/terminal/more-features/files-and-links.mdx + Title (H1): Files, Links, & Scripts + GitBook nav label: Files, links, & scripts + → Add sidebar.label: "Files, links, & scripts" + + src/content/docs/terminal/more-features/markdown-viewer.mdx + Title (H1): Markdown Viewer + GitBook nav label: Markdown viewer + → Add sidebar.label: "Markdown viewer" + + src/content/docs/terminal/more-features/notifications.mdx + Title (H1): Desktop Notifications + GitBook nav label: Desktop notifications + → Add sidebar.label: "Desktop notifications" + + src/content/docs/terminal/more-features/settings-sync.mdx + Title (H1): Settings Sync + GitBook nav label: Settings Sync (Beta) + → Add sidebar.label: "Settings Sync (Beta)" + + src/content/docs/terminal/more-features/uri-scheme.mdx + Title (H1): Warp URI Scheme + GitBook nav label: Warp URI scheme + → Add sidebar.label: "Warp URI scheme" + + src/content/docs/terminal/more-features/working-directory.mdx + Title (H1): Working Directory + GitBook nav label: Working directory + → Add sidebar.label: "Working directory" + + src/content/docs/terminal/sessions/session-navigation.mdx + Title (H1): Session Navigation + GitBook nav label: Session navigation + → Add sidebar.label: "Session navigation" + + src/content/docs/terminal/sessions/session-restoration.mdx + Title (H1): Session Restoration + GitBook nav label: Session restoration + → Add sidebar.label: "Session restoration" + + src/content/docs/terminal/windows/global-hotkey.mdx + Title (H1): Global Hotkey + GitBook nav label: Global hotkey + → Add sidebar.label: "Global hotkey" + + src/content/docs/terminal/windows/vertical-tabs.mdx + Title (H1): Vertical tabs + GitBook nav label: Vertical Tabs + → Add sidebar.label: "Vertical Tabs" + + +## TITLE SENTENCE CASE ISSUES (166 pages) +These titles don't follow sentence case rules. + + src/content/docs/agent-platform/capabilities/agent-notifications.mdx + Current: Agent Notifications + Suggested: Agent notifications + + src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx + Current: Profiles & Permissions + Suggested: Profiles & permissions + + src/content/docs/agent-platform/capabilities/computer-use.mdx + Current: Computer Use + Suggested: Computer use + + src/content/docs/agent-platform/capabilities/full-terminal-use.mdx + Current: Full Terminal Use + Suggested: Full terminal use + + src/content/docs/agent-platform/capabilities/mcp.mdx + Current: Model Context Protocol (MCP) + Suggested: Model context protocol (MCP) + + src/content/docs/agent-platform/capabilities/task-lists.mdx + Current: Agent Task Lists + Suggested: Agent task lists + + src/content/docs/agent-platform/capabilities/web-search.mdx + Current: Web Search + Suggested: Web search + + src/content/docs/agent-platform/cli-agents/overview.mdx + Current: Third-Party CLI Agents + Suggested: Third-party CLI Agents + + src/content/docs/agent-platform/cli-agents/remote-control.mdx + Current: Remote Control + Suggested: Remote control + + src/content/docs/agent-platform/cloud-agents/deployment-patterns.mdx + Current: Deployment Patterns + Suggested: Deployment patterns + + src/content/docs/agent-platform/cloud-agents/integrations/cloud-providers.mdx + Current: Cloud Providers (Preview) + Suggested: Cloud providers (preview) + + src/content/docs/agent-platform/cloud-agents/integrations/demo-issue-triage-bot.mdx + Current: Demo: Issue Triage Bot + Suggested: Demo: issue triage bot + + src/content/docs/agent-platform/cloud-agents/integrations/index.mdx + Current: Integrations Overview + Suggested: Integrations overview + + src/content/docs/agent-platform/cloud-agents/managing-cloud-agents.mdx + Current: Managing Cloud Agents + Suggested: Managing cloud Agents + + src/content/docs/agent-platform/cloud-agents/mcp.mdx + Current: MCP Servers + Suggested: MCP servers + + src/content/docs/agent-platform/cloud-agents/overview.mdx + Current: Cloud Agents Overview + Suggested: Cloud Agents overview + + src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx + Current: Oz Web App + Suggested: Oz web app + + src/content/docs/agent-platform/cloud-agents/platform.mdx + Current: Oz Platform + Suggested: Oz platform + + src/content/docs/agent-platform/cloud-agents/quickstart.mdx + Current: Cloud Agents Quick Start + Suggested: Cloud Agents quick start + + src/content/docs/agent-platform/cloud-agents/self-hosting/managed-direct.mdx + Current: Managed: Direct backend + Suggested: Managed: direct backend + + src/content/docs/agent-platform/cloud-agents/viewing-cloud-agent-runs.mdx + Current: Cloud agent session sharing + Suggested: Cloud Agent session sharing + + src/content/docs/agent-platform/local-agents/active-ai.mdx + Current: Active AI Recommendations + Suggested: Active AI recommendations + + src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx + Current: Blocks as Context + Suggested: Blocks as context + + src/content/docs/agent-platform/local-agents/agent-context/images-as-context.mdx + Current: Images as Context + Suggested: Images as context + + src/content/docs/agent-platform/local-agents/agent-context/index.mdx + Current: Agent Context + Suggested: Agent context + + src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx + Current: Selection as Context + Suggested: Selection as context + + src/content/docs/agent-platform/local-agents/agent-context/urls-as-context.mdx + Current: URLs as Context + Suggested: Urls as context + + src/content/docs/agent-platform/local-agents/agent-context/using-to-add-context.mdx + Current: Using @ to Add Context + Suggested: Using @ to add context + + src/content/docs/agent-platform/local-agents/code-diffs.mdx + Current: Code Diffs + Suggested: Code diffs + + src/content/docs/agent-platform/local-agents/generate.mdx + Current: Generate (Legacy) + Suggested: Generate (legacy) + + src/content/docs/agent-platform/local-agents/interacting-with-agents/conversation-forking.mdx + Current: Conversation Forking + Suggested: Conversation forking + + src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx + Current: Agent Conversations + Suggested: Agent conversations + + src/content/docs/agent-platform/local-agents/session-sharing.mdx + Current: Agent Session Sharing + Suggested: Agent session sharing + + src/content/docs/code/code-editor/code-editor-vim-keybindings.mdx + Current: Code Editor Vim Keybindings + Suggested: Code editor Vim keybindings + + src/content/docs/code/code-editor/file-tree.mdx + Current: File Tree (Project Explorer) + Suggested: File tree (project explorer) + + src/content/docs/code/code-editor/find-and-replace.mdx + Current: Find and Replace + Suggested: Find and replace + + src/content/docs/code/code-editor/index.mdx + Current: Built-in Code Editor + Suggested: Built-in code editor + + src/content/docs/code/code-editor/language-server-protocol.mdx + Current: Language Server Protocol (LSP) + Suggested: Language server protocol (LSP) + + src/content/docs/enterprise/getting-started/getting-started-enterprise.mdx + Current: Getting started with Warp Enterprise + Suggested: Getting started with Warp enterprise + + src/content/docs/enterprise/security-and-compliance/sso.mdx + Current: Single Sign-On (SSO) + Suggested: Single sign-on (SSO) + + src/content/docs/enterprise/security-and-compliance/trust-center.mdx + Current: Trust Center + Suggested: Trust center + + src/content/docs/getting-started/keyboard-shortcuts.mdx + Current: Keyboard Shortcuts + Suggested: Keyboard shortcuts + + src/content/docs/getting-started/migrate-to-warp/migrate-to-warp-from-macos-terminal.mdx + Current: Migrate to Warp from macOS Terminal + Suggested: Migrate to Warp from macOS terminal + + src/content/docs/getting-started/supported-shells.mdx + Current: Supported Shells + Suggested: Supported shells + + src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx + Current: How to: Edit Agent Code in Warp + Suggested: How to: edit Agent code in Warp + + src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx + Current: How to: Explain Your Codebase Using Warp (Rust Codebase) + Suggested: How to: explain your codebase using Warp (rust codebase) + + src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx + Current: How To: Review PRs Like A Senior Dev + Suggested: How to: review PRs like a senior dev + + src/content/docs/guides/agent-workflows/how-to-run-3-agents-in-parallel-summarize-logs-analyze-pr-modify-ui.mdx + Current: How To: Run 3 Agents in Parallel (Summarize Logs + Analyze PR + Modify UI) + Suggested: How to: run 3 Agents in parallel (summarize logs + analyze PR + modify UI) + + src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx + Current: How to run multiple AI coding agents + Suggested: How to run multiple AI coding Agents + + src/content/docs/guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents.mdx + Current: How to use voice and images to prompt coding agents + Suggested: How to use voice and images to Prompt coding Agents + + src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx + Current: Running Multiple Agents At Once With Warp + Suggested: Running multiple Agents at once with Warp + + src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx + Current: Understanding Your Codebase + Suggested: Understanding your codebase + + src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx + Current: Using Images As Context With Warp + Suggested: Using images as context with Warp + + src/content/docs/guides/agent-workflows/warp-for-product-managers.mdx + Current: 5 AI agent workflows for product managers + Suggested: 5 AI Agent Workflows for product managers + + src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx + Current: Building a Chrome Extension (D3.js + Javascript + HTML + CSS) + Suggested: Building a Chrome extension (D3.js + JavaScript + HTML + CSS) + + src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx + Current: Building a Real-time Chat App (Github MCP + Railway ) + Suggested: Building a real-time chat app (GitHub MCP + Railway ) + + src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx + Current: Building Warp's Input - With Warp + Suggested: Building Warp's input - with Warp + + src/content/docs/guides/configuration/creating-rules-for-agents.mdx + Current: Creating Rules For Agents + Suggested: Creating Rules for Agents + + src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx + Current: How To: Configure YOLO and Strategic Agent Profiles + Suggested: How to: configure YOLO and strategic Agent Profiles + + src/content/docs/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind.mdx + Current: How To: Create Project Rules for an Existing Project (Astro + Typescript + Tailwind) + Suggested: How to: create project Rules for an existing project (Astro + TypeScript + Tailwind) + + src/content/docs/guides/configuration/how-to-set-coding-best-practices.mdx + Current: How To: Set Coding Best Practices + Suggested: How to: set coding best practices + + src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx + Current: How To: Set Coding Preferences with Rules + Suggested: How to: set coding preferences with Rules + + src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx + Current: How To: Set Tech Stack Preferences with Rules + Suggested: How to: set tech stack preferences with Rules + + src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx + Current: How to set up self-serve data analytics with Skills + Suggested: How to set up self-serve data analytics with skills + + src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx + Current: How To: Sync Your Monorepos + Suggested: How to: sync your monorepos + + src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx + Current: How To: Use Agent Profiles Efficiently + Suggested: How to: use Agent Profiles efficiently + + src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx + Current: Trigger Reusable Actions With Saved Prompts + Suggested: Trigger reusable actions with saved Prompts + + src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx + Current: How to: Analyze Cloud Run Logs (gcloud) + Suggested: How to: analyze cloud run logs (gcloud) + + src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx + Current: How To: Create a Production Ready Docker Setup + Suggested: How to: create a production ready Docker setup + + src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx + Current: How To: Create Priority Matrix for Database Optimization + Suggested: How to: create priority matrix for database optimization + + src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx + Current: How to: Generate Unit and Security Tests to Debug Faster + Suggested: How to: generate unit and security tests to debug faster + + src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx + Current: How To: Prevent Secrets from Leaking + Suggested: How to: prevent secrets from leaking + + src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx + Current: How To: Write SQL Commands inside a Postgres REPL + Suggested: How to: write SQL commands inside a Postgres REPL + + src/content/docs/guides/devops/improve-your-kubernetes-workflow-kubectl-helm.mdx + Current: Improve Your Kubernetes Workflow (kubectl + helm) + Suggested: Improve your Kubernetes Workflow (kubectl + Helm) + + src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx + Current: Context7 MCP: Update Astro Project with Best Practices + Suggested: Context7 MCP: update Astro project with best practices + + src/content/docs/guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch.mdx + Current: Figma Remote MCP: Create a Website from a Figma File from Scratch + Suggested: Figma remote MCP: create a website from a Figma file from scratch + + src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx + Current: Github MCP: Summarizing Open PRs & Creating GH Issues + Suggested: GitHub MCP: summarizing open PRs & creating gh issues + + src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx + Current: How To Set Up Ollama + Suggested: How to set up Ollama + + src/content/docs/guides/external-tools/linear-mcp-retrieve-issue-data.mdx + Current: Linear MCP: Retrieve issue data + Suggested: Linear MCP: retrieve issue data + + src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx + Current: Linear MCP: Updating Tickets with a Lean Build Approach + Suggested: Linear MCP: updating tickets with a lean build approach + + src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx + Current: Puppeteer MCP: Scraping Amazon Web Reviews + Suggested: Puppeteer MCP: scraping Amazon web reviews + + src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx + Current: Sentry MCP: Fix Sentry Error in Empower Website + Suggested: Sentry MCP: fix Sentry error in empower website + + src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx + Current: SQLite and Stripe MCP: Basic Queries You Can Make After Set Up + Suggested: SQLite and Stripe MCP: basic queries you can make after set up + + src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx + Current: Using MCP Servers with Warp + Suggested: Using MCP servers with Warp + + src/content/docs/guides/frontend/how-to-actually-code-ui-that-matches-your-mockup-react-tailwind.mdx + Current: How To: Actually Code UI That Matches Your Mockup (React + Tailwind) + Suggested: How to: actually code UI that matches your mockup (React + Tailwind) + + src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx + Current: How To: Replace A UI Element in Warp (Rust Codebase) + Suggested: How to: replace a UI element in Warp (rust codebase) + + src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx + Current: 10 Coding Features You Should Know + Suggested: 10 Coding features you should know + + src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx + Current: How to: Customize Warp's Appearance + Suggested: How to: customize Warp's appearance + + src/content/docs/guides/getting-started/how-to-make-warps-ui-more-minimal.mdx + Current: How to Make Warp’s UI More Minimal + Suggested: How to make Warp’s UI more minimal + + src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx + Current: How To Master Warp's Code Review Panel + Suggested: How to master Warp's Code Review panel + + src/content/docs/knowledge-and-collaboration/session-sharing/index.mdx + Current: Session Sharing + Suggested: Session sharing + + src/content/docs/knowledge-and-collaboration/warp-drive/agent-mode-context.mdx + Current: Agent Mode Context + Suggested: Agent Mode context + + src/content/docs/knowledge-and-collaboration/warp-drive/ai-objects.mdx + Current: AI-Integrated Objects + Suggested: AI-integrated objects + + src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.mdx + Current: Environment variables + Suggested: Environment Variables + + src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx + Current: Warp Drive prompts + Suggested: Warp Drive Prompts + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/authentication-required.mdx + Current: authentication_required + Suggested: Authentication_required + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/budget-exceeded.mdx + Current: budget_exceeded + Suggested: Budget_exceeded + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/conflict.mdx + Current: conflict + Suggested: Conflict + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/content-policy-violation.mdx + Current: content_policy_violation + Suggested: Content_policy_violation + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/environment-setup-failed.mdx + Current: environment_setup_failed + Suggested: Environment_setup_failed + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/external-authentication-required.mdx + Current: external_authentication_required + Suggested: External_authentication_required + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/feature-not-available.mdx + Current: feature_not_available + Suggested: Feature_not_available + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/index.mdx + Current: Errors Overview + Suggested: Errors overview + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/insufficient-credits.mdx + Current: insufficient_credits + Suggested: Insufficient_credits + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/integration-disabled.mdx + Current: integration_disabled + Suggested: Integration_disabled + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/integration-not-configured.mdx + Current: integration_not_configured + Suggested: Integration_not_configured + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/internal-error.mdx + Current: internal_error + Suggested: Internal_error + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/invalid-request.mdx + Current: invalid_request + Suggested: Invalid_request + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/not-authorized.mdx + Current: not_authorized + Suggested: Not_authorized + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/operation-not-supported.mdx + Current: operation_not_supported + Suggested: Operation_not_supported + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/resource-not-found.mdx + Current: resource_not_found + Suggested: Resource_not_found + + src/content/docs/reference/api-and-sdk/troubleshooting/errors/resource-unavailable.mdx + Current: resource_unavailable + Suggested: Resource_unavailable + + src/content/docs/reference/api-and-sdk/troubleshooting/index.mdx + Current: API Troubleshooting + Suggested: API troubleshooting + + src/content/docs/reference/cli/agent-profiles.mdx + Current: Agent profiles + Suggested: Agent Profiles + + src/content/docs/reference/cli/quickstart.mdx + Current: Quick Start + Suggested: Quick start + + src/content/docs/reference/cli/troubleshooting.mdx + Current: CLI Troubleshooting + Suggested: CLI troubleshooting + + src/content/docs/support-and-community/community/open-source-partnership.mdx + Current: Oz Open Source Partnership + Suggested: Oz open source partnership + + src/content/docs/support-and-community/community/warp-preview-and-alpha-program.mdx + Current: Warp Preview + Suggested: Warp preview + + src/content/docs/support-and-community/index.mdx + Current: Support & Community + Suggested: Support & community + + src/content/docs/support-and-community/plans-and-billing/bring-your-own-api-key.mdx + Current: Bring Your Own API Key + Suggested: Bring your own API key + + src/content/docs/support-and-community/plans-and-billing/overages-legacy.mdx + Current: Overages (Legacy) + Suggested: Overages (legacy) + + src/content/docs/support-and-community/privacy-and-security/network-log.mdx + Current: Network Log + Suggested: Network log + + src/content/docs/support-and-community/privacy-and-security/secret-redaction.mdx + Current: Secret Redaction + Suggested: Secret redaction + + src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx + Current: Known Issues + Suggested: Known issues + + src/content/docs/support-and-community/troubleshooting-and-support/troubleshooting-login-issues.mdx + Current: Troubleshooting Login + Suggested: Troubleshooting login + + src/content/docs/support-and-community/troubleshooting-and-support/using-warp-offline.mdx + Current: Using Warp Offline + Suggested: Using Warp offline + + src/content/docs/terminal/appearance/blocks-behavior.mdx + Current: Blocks Behavior + Suggested: Blocks behavior + + src/content/docs/terminal/appearance/custom-themes.mdx + Current: Custom Themes + Suggested: Custom themes + + src/content/docs/terminal/appearance/pane-dimming.mdx + Current: Pane Dimming & Focus + Suggested: Pane dimming & focus + + src/content/docs/terminal/appearance/prompt.mdx + Current: Terminal prompt + Suggested: Terminal Prompt + + src/content/docs/terminal/appearance/size-opacity-blurring.mdx + Current: Size, Opacity, & Blurring + Suggested: Size, opacity, & blurring + + src/content/docs/terminal/appearance/tabs-behavior.mdx + Current: Tabs Behavior + Suggested: Tabs behavior + + src/content/docs/terminal/appearance/text-fonts-cursor.mdx + Current: Text, Fonts, & Cursor + Suggested: Text, fonts, & Cursor + + src/content/docs/terminal/blocks/block-actions.mdx + Current: Block Actions + Suggested: Block actions + + src/content/docs/terminal/blocks/block-basics.mdx + Current: Terminal Block Basics + Suggested: Terminal Block basics + + src/content/docs/terminal/blocks/block-filtering.mdx + Current: Block Filtering + Suggested: Block filtering + + src/content/docs/terminal/blocks/block-sharing.mdx + Current: Block Sharing + Suggested: Block sharing + + src/content/docs/terminal/blocks/find.mdx + Current: Terminal Block Find + Suggested: Terminal Block find + + src/content/docs/terminal/blocks/sticky-command-header.mdx + Current: Sticky Command Header + Suggested: Sticky command header + + src/content/docs/terminal/command-completions/index.mdx + Current: Command Completions + Suggested: Command completions + + src/content/docs/terminal/editor/alias-expansion.mdx + Current: Alias Expansion + Suggested: Alias expansion + + src/content/docs/terminal/editor/command-inspector.mdx + Current: Command Inspector + Suggested: Command inspector + + src/content/docs/terminal/editor/index.mdx + Current: Modern Text Editing + Suggested: Modern text editing + + src/content/docs/terminal/editor/syntax-error-highlighting.mdx + Current: Syntax & Error Highlighting + Suggested: Syntax & error highlighting + + src/content/docs/terminal/entry/command-corrections.mdx + Current: Command Corrections + Suggested: Command corrections + + src/content/docs/terminal/entry/command-history.mdx + Current: Command History + Suggested: Command history + + src/content/docs/terminal/entry/command-search.mdx + Current: Command Search + Suggested: Command search + + src/content/docs/terminal/entry/index.mdx + Current: Command Entry + Suggested: Command entry + + src/content/docs/terminal/entry/synchronized-inputs.mdx + Current: Synchronized Inputs + Suggested: Synchronized inputs + + src/content/docs/terminal/input/classic-input.mdx + Current: Classic Input + Suggested: Classic input + + src/content/docs/terminal/input/universal-input.mdx + Current: Universal Input (Legacy) + Suggested: Universal Input (legacy) + + src/content/docs/terminal/integrations-and-plugins.mdx + Current: Terminal Integrations + Suggested: Terminal integrations + + src/content/docs/terminal/more-features/files-and-links.mdx + Current: Files, Links, & Scripts + Suggested: Files, links, & scripts + + src/content/docs/terminal/more-features/index.mdx + Current: More Features + Suggested: More features + + src/content/docs/terminal/more-features/markdown-viewer.mdx + Current: Markdown Viewer + Suggested: Markdown viewer + + src/content/docs/terminal/more-features/notifications.mdx + Current: Desktop Notifications + Suggested: Desktop notifications + + src/content/docs/terminal/more-features/settings-sync.mdx + Current: Settings Sync + Suggested: Settings sync + + src/content/docs/terminal/more-features/uri-scheme.mdx + Current: Warp URI Scheme + Suggested: Warp URI scheme + + src/content/docs/terminal/more-features/working-directory.mdx + Current: Working Directory + Suggested: Working directory + + src/content/docs/terminal/sessions/launch-configurations.mdx + Current: Launch Configurations (Legacy) + Suggested: Launch configurations (legacy) + + src/content/docs/terminal/sessions/session-navigation.mdx + Current: Session Navigation + Suggested: Session navigation + + src/content/docs/terminal/sessions/session-restoration.mdx + Current: Session Restoration + Suggested: Session restoration + + src/content/docs/terminal/settings/all-settings.mdx + Current: All settings reference + Suggested: All Settings reference + + src/content/docs/terminal/windows/global-hotkey.mdx + Current: Global Hotkey + Suggested: Global hotkey + + src/content/docs/terminal/windows/index.mdx + Current: Windows and Tabs + Suggested: Windows and tabs + + src/content/docs/terminal/windows/tab-configs.mdx + Current: Tab Configs + Suggested: Tab configs + + +## NAV LABEL SENTENCE CASE ISSUES (130 pages) +These nav labels don't follow sentence case rules. + + src/content/docs/agent-platform/capabilities/agent-notifications.mdx + Current (title (fallback)): Agent Notifications + Suggested: Agent notifications + + src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx + Current (title (fallback)): Profiles & Permissions + Suggested: Profiles & permissions + + src/content/docs/agent-platform/capabilities/computer-use.mdx + Current (title (fallback)): Computer Use + Suggested: Computer use + + src/content/docs/agent-platform/capabilities/full-terminal-use.mdx + Current (title (fallback)): Full Terminal Use + Suggested: Full terminal use + + src/content/docs/agent-platform/capabilities/mcp.mdx + Current (title (fallback)): Model Context Protocol (MCP) + Suggested: Model Context Protocol (MCP) + + src/content/docs/agent-platform/capabilities/task-lists.mdx + Current (title (fallback)): Agent Task Lists + Suggested: Agent task lists + + src/content/docs/agent-platform/capabilities/web-search.mdx + Current (title (fallback)): Web Search + Suggested: Web search + + src/content/docs/agent-platform/cli-agents/overview.mdx + Current (title (fallback)): Third-Party CLI Agents + Suggested: Third-party CLI agents + + src/content/docs/agent-platform/cloud-agents/deployment-patterns.mdx + Current (title (fallback)): Deployment Patterns + Suggested: Deployment patterns + + src/content/docs/agent-platform/cloud-agents/integrations/cloud-providers.mdx + Current (title (fallback)): Cloud Providers (Preview) + Suggested: Cloud providers (preview) + + src/content/docs/agent-platform/cloud-agents/integrations/demo-issue-triage-bot.mdx + Current (title (fallback)): Demo: Issue Triage Bot + Suggested: Demo: issue triage bot + + src/content/docs/agent-platform/cloud-agents/managing-cloud-agents.mdx + Current (title (fallback)): Managing Cloud Agents + Suggested: Managing cloud agents + + src/content/docs/agent-platform/cloud-agents/mcp.mdx + Current (title (fallback)): MCP Servers + Suggested: MCP servers + + src/content/docs/agent-platform/cloud-agents/overview.mdx + Current (title (fallback)): Cloud Agents Overview + Suggested: Cloud agents overview + + src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx + Current (title (fallback)): Oz Web App + Suggested: Oz web app + + src/content/docs/agent-platform/cloud-agents/platform.mdx + Current (title (fallback)): Oz Platform + Suggested: Oz platform + + src/content/docs/agent-platform/cloud-agents/quickstart.mdx + Current (title (fallback)): Cloud Agents Quick Start + Suggested: Cloud agents quickstart + + src/content/docs/agent-platform/cloud-agents/viewing-cloud-agent-runs.mdx + Current (title (fallback)): Cloud agent session sharing + Suggested: Cloud agent session sharing + + src/content/docs/agent-platform/local-agents/active-ai.mdx + Current (title (fallback)): Active AI Recommendations + Suggested: Active AI recommendations + + src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx + Current (title (fallback)): Blocks as Context + Suggested: Blocks as context + + src/content/docs/agent-platform/local-agents/agent-context/images-as-context.mdx + Current (title (fallback)): Images as Context + Suggested: Images as context + + src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx + Current (title (fallback)): Selection as Context + Suggested: Selection as context + + src/content/docs/agent-platform/local-agents/agent-context/urls-as-context.mdx + Current (title (fallback)): URLs as Context + Suggested: URLs as context + + src/content/docs/agent-platform/local-agents/agent-context/using-to-add-context.mdx + Current (title (fallback)): Using @ to Add Context + Suggested: Using @ to add context + + src/content/docs/agent-platform/local-agents/code-diffs.mdx + Current (title (fallback)): Code Diffs + Suggested: Code diffs + + src/content/docs/agent-platform/local-agents/generate.mdx + Current (title (fallback)): Generate (Legacy) + Suggested: Generate (legacy) + + src/content/docs/agent-platform/local-agents/interacting-with-agents/conversation-forking.mdx + Current (title (fallback)): Conversation Forking + Suggested: Conversation forking + + src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx + Current (sidebar.ts): Agent Conversations + Suggested: Agent conversations + + src/content/docs/agent-platform/local-agents/session-sharing.mdx + Current (title (fallback)): Agent Session Sharing + Suggested: Agent session sharing + + src/content/docs/code/code-editor/code-editor-vim-keybindings.mdx + Current (title (fallback)): Code Editor Vim Keybindings + Suggested: Code editor Vim keybindings + + src/content/docs/code/code-editor/file-tree.mdx + Current (title (fallback)): File Tree (Project Explorer) + Suggested: File tree (project explorer) + + src/content/docs/code/code-editor/find-and-replace.mdx + Current (title (fallback)): Find and Replace + Suggested: Find and replace + + src/content/docs/enterprise/getting-started/getting-started-enterprise.mdx + Current (title (fallback)): Getting started with Warp Enterprise + Suggested: Getting started with Warp enterprise + + src/content/docs/getting-started/keyboard-shortcuts.mdx + Current (title (fallback)): Keyboard Shortcuts + Suggested: Keyboard shortcuts + + src/content/docs/getting-started/migrate-to-warp/migrate-to-warp-from-macos-terminal.mdx + Current (title (fallback)): Migrate to Warp from macOS Terminal + Suggested: Migrate to Warp from macOS terminal + + src/content/docs/getting-started/supported-shells.mdx + Current (title (fallback)): Supported Shells + Suggested: Supported shell + + src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx + Current (frontmatter): Configure YOLO and Strategic Agent Profiles + Suggested: Configure YOLO and strategic Agent Profiles + + src/content/docs/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind.mdx + Current (frontmatter): Create Project Rules for an existing project + Suggested: Create project Rules for an existing project + + src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx + Current (frontmatter): Set up self-serve data analytics with Skills + Suggested: Set up self-serve data analytics with skills + + src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx + Current (frontmatter): Trigger reusable actions with Saved Prompts + Suggested: Trigger reusable actions with saved prompts + + src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx + Current (frontmatter): Analyze Cloud Run logs + Suggested: Analyze cloud run logs + + src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx + Current (frontmatter): Context7 MCP: Update Astro project with best practices + Suggested: Context7 MCP: update Astro project with best practices + + src/content/docs/guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch.mdx + Current (frontmatter): Figma Remote MCP: Create a website from a Figma file from scratch + Suggested: Figma remote MCP: create a website from a Figma file + + src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx + Current (frontmatter): GitHub MCP: Summarize open PRs and create GitHub issues + Suggested: GitHub MCP: summarize open PRs and create GitHub issues + + src/content/docs/guides/external-tools/linear-mcp-retrieve-issue-data.mdx + Current (title (fallback)): Linear MCP: Retrieve issue data + Suggested: Linear MCP: retrieve issue data + + src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx + Current (frontmatter): Linear MCP: Update tickets with a lean build approach + Suggested: Linear MCP: update tickets with a lean build approach + + src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx + Current (frontmatter): Puppeteer MCP: Scrape Amazon web reviews + Suggested: Puppeteer MCP: scrape Amazon web reviews + + src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx + Current (frontmatter): Sentry MCP: Fix Sentry error in Empower website + Suggested: Sentry MCP: fix Sentry error in empower website + + src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx + Current (frontmatter): SQLite and Stripe MCP: Basic queries you can make after setup + Suggested: SQLite and Stripe MCP: basic queries you can make after setup + + src/content/docs/knowledge-and-collaboration/session-sharing/index.mdx + Current (sidebar.ts): Session Sharing + Suggested: Session sharing + + src/content/docs/knowledge-and-collaboration/warp-drive/agent-mode-context.mdx + Current (title (fallback)): Agent Mode Context + Suggested: Agent Mode context + + src/content/docs/knowledge-and-collaboration/warp-drive/ai-objects.mdx + Current (title (fallback)): AI-Integrated Objects + Suggested: AI-integrated objects + + src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.mdx + Current (title (fallback)): Environment variables + Suggested: Environment Variables + + src/content/docs/reference/api-and-sdk/index.mdx + Current (sidebar.ts): Oz Agent API & SDK + Suggested: Oz agent API & SDK + + src/content/docs/reference/cli/agent-profiles.mdx + Current (title (fallback)): Agent profiles + Suggested: Agent Profiles + + src/content/docs/reference/cli/quickstart.mdx + Current (title (fallback)): Quick Start + Suggested: Quick start + + src/content/docs/reference/cli/troubleshooting.mdx + Current (title (fallback)): CLI Troubleshooting + Suggested: CLI troubleshooting + + src/content/docs/support-and-community/community/open-source-partnership.mdx + Current (title (fallback)): Oz Open Source Partnership + Suggested: Oz open source partnership + + src/content/docs/support-and-community/plans-and-billing/bring-your-own-api-key.mdx + Current (title (fallback)): Bring Your Own API Key + Suggested: Bring your own API key + + src/content/docs/support-and-community/plans-and-billing/overages-legacy.mdx + Current (title (fallback)): Overages (Legacy) + Suggested: Overages (legacy) + + src/content/docs/support-and-community/privacy-and-security/network-log.mdx + Current (title (fallback)): Network Log + Suggested: Network log + + src/content/docs/support-and-community/privacy-and-security/secret-redaction.mdx + Current (title (fallback)): Secret Redaction + Suggested: Secret redaction + + src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx + Current (title (fallback)): Known Issues + Suggested: Known issues + + src/content/docs/support-and-community/troubleshooting-and-support/troubleshooting-login-issues.mdx + Current (title (fallback)): Troubleshooting Login + Suggested: Troubleshooting login + + src/content/docs/support-and-community/troubleshooting-and-support/using-warp-offline.mdx + Current (title (fallback)): Using Warp Offline + Suggested: Using Warp offline + + src/content/docs/terminal/appearance/blocks-behavior.mdx + Current (title (fallback)): Blocks Behavior + Suggested: Blocks behavior + + src/content/docs/terminal/appearance/custom-themes.mdx + Current (title (fallback)): Custom Themes + Suggested: Custom themes + + src/content/docs/terminal/appearance/pane-dimming.mdx + Current (title (fallback)): Pane Dimming & Focus + Suggested: Pane dimming & focus + + src/content/docs/terminal/appearance/size-opacity-blurring.mdx + Current (title (fallback)): Size, Opacity, & Blurring + Suggested: Size, opacity, & blurring + + src/content/docs/terminal/appearance/tabs-behavior.mdx + Current (title (fallback)): Tabs Behavior + Suggested: Tabs behavior + + src/content/docs/terminal/appearance/text-fonts-cursor.mdx + Current (title (fallback)): Text, Fonts, & Cursor + Suggested: Text, fonts, & cursor + + src/content/docs/terminal/blocks/block-actions.mdx + Current (title (fallback)): Block Actions + Suggested: Block actions + + src/content/docs/terminal/blocks/block-basics.mdx + Current (title (fallback)): Terminal Block Basics + Suggested: Block basics + + src/content/docs/terminal/blocks/block-filtering.mdx + Current (title (fallback)): Block Filtering + Suggested: Block filtering + + src/content/docs/terminal/blocks/block-sharing.mdx + Current (title (fallback)): Block Sharing + Suggested: Block sharing + + src/content/docs/terminal/blocks/find.mdx + Current (title (fallback)): Terminal Block Find + Suggested: Block find + + src/content/docs/terminal/editor/alias-expansion.mdx + Current (title (fallback)): Alias Expansion + Suggested: Alias expansion + + src/content/docs/terminal/editor/command-inspector.mdx + Current (title (fallback)): Command Inspector + Suggested: Command inspector + + src/content/docs/terminal/editor/syntax-error-highlighting.mdx + Current (title (fallback)): Syntax & Error Highlighting + Suggested: Syntax & error highlighting + + src/content/docs/terminal/entry/command-corrections.mdx + Current (title (fallback)): Command Corrections + Suggested: Command corrections + + src/content/docs/terminal/entry/command-history.mdx + Current (title (fallback)): Command History + Suggested: Command history + + src/content/docs/terminal/entry/command-search.mdx + Current (title (fallback)): Command Search + Suggested: Command search + + src/content/docs/terminal/entry/synchronized-inputs.mdx + Current (title (fallback)): Synchronized Inputs + Suggested: Synchronized inputs + + src/content/docs/terminal/input/classic-input.mdx + Current (title (fallback)): Classic Input + Suggested: Classic input + + src/content/docs/terminal/input/universal-input.mdx + Current (title (fallback)): Universal Input (Legacy) + Suggested: Universal Input (legacy) + + src/content/docs/terminal/integrations-and-plugins.mdx + Current (title (fallback)): Terminal Integrations + Suggested: Terminal integrations + + src/content/docs/terminal/more-features/files-and-links.mdx + Current (title (fallback)): Files, Links, & Scripts + Suggested: Files, links, & scripts + + src/content/docs/terminal/more-features/markdown-viewer.mdx + Current (title (fallback)): Markdown Viewer + Suggested: Markdown viewer + + src/content/docs/terminal/more-features/notifications.mdx + Current (title (fallback)): Desktop Notifications + Suggested: Desktop notifications + + src/content/docs/terminal/more-features/settings-sync.mdx + Current (title (fallback)): Settings Sync + Suggested: Settings sync + + src/content/docs/terminal/more-features/uri-scheme.mdx + Current (title (fallback)): Warp URI Scheme + Suggested: Warp URI scheme + + src/content/docs/terminal/more-features/working-directory.mdx + Current (title (fallback)): Working Directory + Suggested: Working directory + + src/content/docs/terminal/sessions/launch-configurations.mdx + Current (title (fallback)): Launch Configurations (Legacy) + Suggested: Launch configurations (legacy) + + src/content/docs/terminal/sessions/session-navigation.mdx + Current (title (fallback)): Session Navigation + Suggested: Session navigation + + src/content/docs/terminal/sessions/session-restoration.mdx + Current (title (fallback)): Session Restoration + Suggested: Session restoration + + src/content/docs/terminal/settings/all-settings.mdx + Current (title (fallback)): All settings reference + Suggested: All Settings reference + + src/content/docs/terminal/windows/global-hotkey.mdx + Current (title (fallback)): Global Hotkey + Suggested: Global hotkey + + src/content/docs/terminal/windows/tab-configs.mdx + Current (title (fallback)): Tab Configs + Suggested: Tab configs + +================================================================================ +SUMMARY + Missing nav labels: 97 + Title sentence case issues: 166 + Label sentence case issues: 130 + Total pages with issues: 199 + Total pages scanned: 306 +================================================================================ diff --git a/src/content/docs/agent-platform/cloud-agents/overview.mdx b/src/content/docs/agent-platform/cloud-agents/overview.mdx index 60b5c94..dd242d5 100644 --- a/src/content/docs/agent-platform/cloud-agents/overview.mdx +++ b/src/content/docs/agent-platform/cloud-agents/overview.mdx @@ -10,7 +10,7 @@ import VideoEmbed from '@components/VideoEmbed.astro'; Oz Cloud Agents are **cloud-connected**, **background agents** that run on the [Oz Platform](/agent-platform/cloud-agents/platform/). -**New to cloud agents?** Start with the [Cloud Agents Quick Start](/agent-platform/cloud-agents/quickstart/) to run your first cloud agent in ~10 minutes. +**New to cloud agents?** Start with the [Cloud agents quickstart](/agent-platform/cloud-agents/quickstart/) to run your first cloud agent in ~10 minutes. @@ -144,7 +144,7 @@ If your credit balance reaches zero, cloud agent runs will not be able to execut ### Learn more -* [Cloud Agents Quick Start](/agent-platform/cloud-agents/quickstart/) — run your first cloud agent with an environment in ~10 minutes. +* [Cloud agents quickstart](/agent-platform/cloud-agents/quickstart/) — run your first cloud agent with an environment in ~10 minutes. * [Oz Platform](/agent-platform/cloud-agents/platform/) — CLI, Oz API/SDK, orchestration, tasks, environments, hosts, integrations, and more. * [Skills as Agents](/agent-platform/cloud-agents/skills-as-agents/) — run agents based on reusable skill definitions from the CLI, web app, API, or on a schedule. * [Oz CLI](/reference/cli/) — shows how to run Oz agents in non-interactive mode from CI, scripts, or remote machines, including auth and common commands. diff --git a/src/content/docs/agent-platform/cloud-agents/platform.mdx b/src/content/docs/agent-platform/cloud-agents/platform.mdx index c2e1101..7913c03 100644 --- a/src/content/docs/agent-platform/cloud-agents/platform.mdx +++ b/src/content/docs/agent-platform/cloud-agents/platform.mdx @@ -13,7 +13,7 @@ Cloud agents run on the **Oz Platform**. The platform gives you a consistent way :::note -**New to cloud agents?** Start with the [Cloud Agents Quick Start](/agent-platform/cloud-agents/quickstart/) to run your first agent in ~10 minutes. +**New to cloud agents?** Start with the [Cloud agents quickstart](/agent-platform/cloud-agents/quickstart/) to run your first agent in ~10 minutes. ::: **Most production setups follow the same flow:** diff --git a/src/content/docs/agent-platform/cloud-agents/quickstart.mdx b/src/content/docs/agent-platform/cloud-agents/quickstart.mdx index efc00b5..a8d1def 100644 --- a/src/content/docs/agent-platform/cloud-agents/quickstart.mdx +++ b/src/content/docs/agent-platform/cloud-agents/quickstart.mdx @@ -1,5 +1,5 @@ --- -title: Cloud Agents Quick Start +title: Cloud agents quickstart description: >- Learn how to run your first Oz cloud agent in ~10 minutes. Cloud agents run in remote environments, enabling automation, scheduling, and team @@ -101,7 +101,7 @@ Follow the prompts to save your task definition. Once created, you can run it ag **How this works:** Skills capture successful agent workflows as reusable building blocks. Instead of typing the same prompt repeatedly, you define it once. You can use it yourself, share it with teammates, schedule it to run automatically, or trigger it from integrations. Learn more about [Skills as Agents](/agent-platform/cloud-agents/skills-as-agents/). -**Prefer using the CLI?** See the [Oz CLI Quick Start](/reference/cli/quickstart/) for CLI-based workflows. +**Prefer using the CLI?** See the [Oz CLI quickstart](/reference/cli/quickstart/) for CLI-based workflows. --- diff --git a/src/content/docs/reference/cli/index.mdx b/src/content/docs/reference/cli/index.mdx index 19f1bba..76bb785 100644 --- a/src/content/docs/reference/cli/index.mdx +++ b/src/content/docs/reference/cli/index.mdx @@ -152,7 +152,7 @@ Use an API key when the environment must authenticate on its own, such as CI pip For detailed instructions on creating, managing, and using API keys, see [API Keys](/reference/cli/api-keys/). -**Quick start:** +**Quickstart:** ```sh $ export WARP_API_KEY="wk-xxx..." diff --git a/src/content/docs/reference/cli/integration-setup.mdx b/src/content/docs/reference/cli/integration-setup.mdx index 27dfa16..97db4c3 100644 --- a/src/content/docs/reference/cli/integration-setup.mdx +++ b/src/content/docs/reference/cli/integration-setup.mdx @@ -20,7 +20,7 @@ Note: While cloud agents can be run individually via CLI without a team, integra ::: :::note -For a quick start guide to Warp integrations, please see the [Integrations Overview](/agent-platform/cloud-agents/integrations/). +For a quickstart guide to Warp integrations, see the [Integrations overview](/agent-platform/cloud-agents/integrations/). ::: ## How integrations and environments work diff --git a/src/content/docs/reference/cli/quickstart.mdx b/src/content/docs/reference/cli/quickstart.mdx index d887f80..de2a145 100644 --- a/src/content/docs/reference/cli/quickstart.mdx +++ b/src/content/docs/reference/cli/quickstart.mdx @@ -1,5 +1,5 @@ --- -title: Quick Start +title: CLI quickstart description: >- Set up and run your first cloud agent via the Oz CLI in less than 5 minutes. sidebar: diff --git a/src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx b/src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx index 174c38f..abdbaf9 100644 --- a/src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx +++ b/src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx @@ -314,6 +314,6 @@ The following non-exhaustive list of plugins, prompts, or tools can cause potent sudo apt update && sudo apt install warp-terminal ``` - See the instructions for other Linux distros on our [Quick Start Guide](/getting-started/quickstart/installation-and-setup/#linux). +See the instructions for other Linux distros on our [quickstart guide](/getting-started/quickstart/installation-and-setup/#linux). diff --git a/src/content/docs/terminal/entry/command-search.mdx b/src/content/docs/terminal/entry/command-search.mdx index 5e68f2e..5d340fc 100644 --- a/src/content/docs/terminal/entry/command-search.mdx +++ b/src/content/docs/terminal/entry/command-search.mdx @@ -16,7 +16,7 @@ The Command Search panel provides unified search across all your terminal inputs Tailor your Command Search experience by toggling off "Show Global Workflows" in **Settings** > **Features** > **Workflows**. When disabled, your search will exclusively encompass YAML and Warp Drive Workflows. ::: -## Quick Start +## Quickstart 1. Press `CTRL-R` to open the Command Search Panel 2. Type your search query in the input box From 2d2296e491e9cf916d09c37e9e5dd0e8a5365c70 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Mon, 4 May 2026 08:17:42 -1000 Subject: [PATCH 8/8] chore: remove audit scripts from PR These are local utility scripts, not part of the docs site. Co-Authored-By: Oz --- scripts/apply-nav-labels.py | 166 ---- scripts/audit-nav-labels.py | 406 --------- scripts/audit-report.txt | 1564 ----------------------------------- 3 files changed, 2136 deletions(-) delete mode 100644 scripts/apply-nav-labels.py delete mode 100644 scripts/audit-nav-labels.py delete mode 100644 scripts/audit-report.txt diff --git a/scripts/apply-nav-labels.py b/scripts/apply-nav-labels.py deleted file mode 100644 index 4048abf..0000000 --- a/scripts/apply-nav-labels.py +++ /dev/null @@ -1,166 +0,0 @@ -#!/usr/bin/env python3 -"""Apply nav label fixes from curated audit-report.txt. - -Parses the human-reviewed audit report and applies: -1. Missing nav labels (section 1) — adds sidebar.label to frontmatter -2. Nav label sentence case fixes (section 3) — adds/updates sidebar.label - -Skips: -- Error pages in reference/api-and-sdk/troubleshooting/errors/ -- sidebar.ts overrides (those entries are left as-is) - -Usage: - python3 scripts/apply-nav-labels.py # dry run - python3 scripts/apply-nav-labels.py --apply # apply changes -""" - -import re -import sys -from pathlib import Path - -DOCS_REPO = Path(__file__).resolve().parent.parent -REPORT_PATH = DOCS_REPO / "scripts" / "audit-report.txt" -CONTENT_ROOT = DOCS_REPO / "src" / "content" / "docs" - -# Skip error code pages (intentionally lowercase) -SKIP_PATTERNS = [ - "reference/api-and-sdk/troubleshooting/errors/", -] - - -def parse_report(): - """Parse the curated audit-report.txt into a dict of {file_path: label}.""" - changes = {} # relative_path -> sidebar_label - - with open(REPORT_PATH) as f: - content = f.read() - - # Section 1: MISSING NAV LABELS - # Pattern: lines like '→ Add sidebar.label: "Some label"' - # preceded by file path lines - section1_match = re.search( - r'## MISSING NAV LABELS.*?\n(.*?)(?=\n## TITLE SENTENCE CASE)', - content, re.DOTALL - ) - if section1_match: - block = section1_match.group(1) - # Parse file + label pairs - entries = re.findall( - r'^\s+(src/content/docs/\S+)\s*\n' - r'.*?\n.*?\n' - r'\s+→ Add sidebar\.label: "([^"]+)"', - block, re.MULTILINE - ) - for filepath, label in entries: - if not any(skip in filepath for skip in SKIP_PATTERNS): - changes[filepath] = label - - # Section 3: NAV LABEL SENTENCE CASE ISSUES - # Pattern: file path, then "Current (source): ...", then "Suggested: ..." - section3_match = re.search( - r'## NAV LABEL SENTENCE CASE ISSUES.*?\n(.*?)(?=\n={5,})', - content, re.DOTALL - ) - if section3_match: - block = section3_match.group(1) - entries = re.findall( - r'^\s+(src/content/docs/\S+)\s*\n' - r'\s+Current \(([^)]+)\):.*?\n' - r'\s+Suggested: (.+)', - block, re.MULTILINE - ) - for filepath, source, suggested in entries: - suggested = suggested.strip() - # Skip sidebar.ts entries (we don't modify sidebar.ts) - if source == "sidebar.ts": - continue - # Skip error pages - if any(skip in filepath for skip in SKIP_PATTERNS): - continue - # Don't overwrite section 1 entries (they were reviewed first) - if filepath not in changes: - changes[filepath] = suggested - - return changes - - -def apply_sidebar_label(mdx_path, label): - """Add or update sidebar.label in an MDX file's frontmatter.""" - content = mdx_path.read_text() - - # Find frontmatter bounds - fm_match = re.match(r'^(---\s*\n)(.*?\n)(---)', content, re.DOTALL) - if not fm_match: - return False - - fm_text = fm_match.group(2) - fm_start = fm_match.start(2) - fm_end = fm_match.end(2) - - # Case 1: sidebar.label already exists — update it - # Use [ \t]* instead of \s* to avoid consuming newlines - existing = re.search( - r'^(\s+label:\s*)["\']?.*?["\']?[ \t]*$', - fm_text, re.MULTILINE - ) - if existing and 'sidebar:' in fm_text: - new_fm = fm_text[:existing.start()] + f' label: "{label}"' + fm_text[existing.end():] - new_content = content[:fm_start] + new_fm + content[fm_end:] - mdx_path.write_text(new_content) - return True - - # Case 2: sidebar: block exists but no label - sidebar_match = re.search(r'^sidebar:\s*$', fm_text, re.MULTILINE) - if sidebar_match: - insert_pos = sidebar_match.end() - new_fm = fm_text[:insert_pos] + f'\n label: "{label}"' + fm_text[insert_pos:] - new_content = content[:fm_start] + new_fm + content[fm_end:] - mdx_path.write_text(new_content) - return True - - # Case 3: No sidebar block — add before closing --- - new_fm = fm_text.rstrip('\n') + f'\nsidebar:\n label: "{label}"\n' - new_content = content[:fm_start] + new_fm + content[fm_end:] - mdx_path.write_text(new_content) - return True - - -def main(): - dry_run = "--apply" not in sys.argv - - if dry_run: - print("DRY RUN — pass --apply to make changes\n") - - changes = parse_report() - print(f"Found {len(changes)} nav label changes to apply.\n") - - applied = 0 - skipped = 0 - for rel_path, label in sorted(changes.items()): - mdx_path = DOCS_REPO / rel_path - if not mdx_path.exists(): - print(f" SKIP (not found): {rel_path}") - skipped += 1 - continue - - print(f" {rel_path}") - print(f" sidebar.label: \"{label}\"") - - if not dry_run: - if apply_sidebar_label(mdx_path, label): - print(f" ✓ applied") - applied += 1 - else: - print(f" ⚠ failed (no frontmatter?)") - skipped += 1 - else: - applied += 1 - - print() - - action = "Would apply" if dry_run else "Applied" - print(f"\n{action}: {applied} | Skipped: {skipped}") - - -if __name__ == "__main__": - main() diff --git a/scripts/audit-nav-labels.py b/scripts/audit-nav-labels.py deleted file mode 100644 index 7221525..0000000 --- a/scripts/audit-nav-labels.py +++ /dev/null @@ -1,406 +0,0 @@ -#!/usr/bin/env python3 -"""Audit nav labels and sentence case across docs. - -Compares GitBook SUMMARY.md nav labels against Astro frontmatter titles, -identifies pages that need sidebar.label overrides, and flags sentence case -issues in titles and existing labels. - -Usage: - python3 scripts/audit-nav-labels.py -""" - -import os -import re -import sys -import yaml -from pathlib import Path -from typing import Dict, Optional - -# --------------------------------------------------------------------------- -# Configuration -# --------------------------------------------------------------------------- - -DOCS_REPO = Path(__file__).resolve().parent.parent -GITBOOK_REPO = Path.home() / "Documents" / "Warp" / "gitbook" -ASTRO_CONTENT = DOCS_REPO / "src" / "content" / "docs" - -# GitBook spaces and their corresponding Astro prefixes -GITBOOK_SPACES = { - "docs/warp": "", # maps to root-level dirs in Astro - "docs/agent-platform": "agent-platform", - "docs/reference": "reference", - "docs/support-and-community": "support-and-community", - "docs/enterprise": "enterprise", - "docs/changelog": "changelog", -} - -# Proper nouns that retain capitalization (from terminology.md) -# These are matched case-insensitively and restored to their canonical form. -PROPER_NOUNS = [ - # Multi-word first (order matters for replacement) - "Agent Management Panel", "Agent Mode", "Agent Profiles", - "Auto-detection Mode", "Terminal Mode", "Universal Input", - "Warp Drive", "Admin Panel", "Command Palette", - "Codebase Context", "Code Review", "Ambient Agents", - "Slash Commands", "Environment Variables", "Environment Variable", - "Cloud Agent Credits", "Add-on Credits", - "Oz cloud agent", "Oz web app", "Oz dashboard", - "Oz subagent", "Oz agent", "Oz conversation", "Oz run", - "GitHub Actions", "GitHub App", "Claude Code", - "AGPL v3", "Azure DevOps", "Windows Terminal", "VS Code", - "Google Cloud", - # Single-word proper nouns - "Warp", "Oz", "Warpify", "Agent", "Agents", "Block", "Blocks", - "Settings", "Rules", "Notebooks", "Notebook", - "Workflows", "Workflow", "Prompts", "Prompt", - "GitHub", "Linear", "Slack", "Codex", "Gemini", "OpenCode", - "Git", "Vim", "Docker", "Kubernetes", "Vercel", "Figma", - "Sentry", "Puppeteer", "Ollama", "Railway", "Bitbucket", "GitLab", - # External product names (not in terminology.md but still proper nouns) - "Linux", "Windows", "Chrome", "Cursor", "Ghostty", "iTerm2", - "Postgres", "PostgreSQL", "Astro", "Tailwind", "React", - "TypeScript", "JavaScript", "Slackbot", "DevOps", - "Helm", "Stripe", "SQLite", "Amazon", "Context7", - # Acronyms / always-caps - "MCP", "SSH", "LSP", "CLI", "API", "SDK", "SSO", "FAQ", "FAQs", - "UI", "URI", "GCP", "SQL", "PR", "PRs", "DNS", "CSS", "HTML", - "JSON", "YAML", "AI", "LLM", "REPL", "YOLO", - # Special casing - "macOS", "D3.js", "gcloud", -] - -# Build a lookup: lowercase -> canonical form -PROPER_NOUN_MAP = {} -for noun in PROPER_NOUNS: - PROPER_NOUN_MAP[noun.lower()] = noun - - -# --------------------------------------------------------------------------- -# Parsing helpers -# --------------------------------------------------------------------------- - -def parse_summary_md(path: Path) -> Dict[str, str]: - """Parse a GitBook SUMMARY.md and return {relative_path: nav_label}. - - GitBook format: - * [Link Text](path/to/file.md) -> nav label = "Link Text" - * [Link Text](path/to/file.md "Override") -> nav label = "Override" - """ - entries = {} - if not path.exists(): - return entries - - pattern = re.compile( - r'\*\s+\[([^\]]+)\]' # [Link Text] - r'\(([^)"\s]+)' # (path - r'(?:\s+"([^"]+)")?' # optional "Override" - r'\)' # ) - ) - - with open(path) as f: - for line in f: - m = pattern.search(line) - if m: - link_text = m.group(1).strip() - file_path = m.group(2).strip() - override = m.group(3) - nav_label = override.strip() if override else link_text - entries[file_path] = nav_label - - return entries - - -def gitbook_path_to_astro(gitbook_path: str, space_prefix: str) -> Optional[Path]: - """Map a GitBook file path to an Astro MDX file path.""" - # README.md -> index.mdx - if gitbook_path.endswith("README.md"): - astro_path = gitbook_path.replace("README.md", "index.mdx") - else: - astro_path = gitbook_path.replace(".md", ".mdx") - - if space_prefix: - full_path = ASTRO_CONTENT / space_prefix / astro_path - else: - full_path = ASTRO_CONTENT / astro_path - - if full_path.exists(): - return full_path - - # Try without the space prefix mapping for warp/ space which maps to - # multiple top-level dirs - if not space_prefix: - # The warp space files map directly (terminal/, code/, etc.) - return full_path if full_path.exists() else None - - return None - - -def extract_frontmatter(path: Path) -> dict: - """Extract YAML frontmatter from an MDX file.""" - with open(path) as f: - content = f.read() - - match = re.match(r'^---\s*\n(.*?)\n---', content, re.DOTALL) - if not match: - return {} - - try: - return yaml.safe_load(match.group(1)) or {} - except yaml.YAMLError: - return {} - - -def to_sentence_case(text: str) -> str: - """Convert text to sentence case, preserving proper nouns. - - Strategy: work word-by-word. For each word (or multi-word proper noun), - check if it matches a known proper noun. If so, use the canonical form. - Otherwise, lowercase it (except the very first word gets capitalized). - """ - if not text: - return text - - # Build a set of multi-word proper nouns for phrase matching - sorted_nouns = sorted(PROPER_NOUNS, key=len, reverse=True) - - # Step 1: Protect proper nouns by replacing with indexed placeholders. - # Use § markers that won't appear in real text. - protected = [] # list of (placeholder, canonical) - working = text - - for noun in sorted_nouns: - pattern = re.compile(r'\b' + re.escape(noun) + r'\b', re.IGNORECASE) - # Find all matches but only replace if the match is clean - while True: - m = pattern.search(working) - if not m: - break - idx = len(protected) - placeholder = f"§{idx}§" - canonical = PROPER_NOUN_MAP[noun.lower()] - protected.append((placeholder, canonical)) - working = working[:m.start()] + placeholder + working[m.end():] - - # Step 2: Apply sentence case to the remaining (non-proper-noun) text. - # Split on placeholders to process only the plain-text segments. - # Tokenize: split into segments of [text, placeholder, text, placeholder, ...] - parts = re.split(r'(§\d+§)', working) - - first_alpha_done = False - result_parts = [] - for part in parts: - if re.match(r'^§\d+§$', part): - # This is a placeholder — check if it's the first alphabetic content - if not first_alpha_done: - first_alpha_done = True - result_parts.append(part) - else: - # Plain text — lowercase it - lowered = part.lower() - if not first_alpha_done: - # Capitalize the first alpha char in the entire string - chars = list(lowered) - for i, ch in enumerate(chars): - if ch.isalpha(): - chars[i] = ch.upper() - first_alpha_done = True - break - lowered = ''.join(chars) - result_parts.append(lowered) - - result = ''.join(result_parts) - - # Step 3: Restore proper nouns - for placeholder, canonical in protected: - result = result.replace(placeholder, canonical) - - return result - - -def has_sentence_case_issues(text: str) -> bool: - """Check if text has sentence case issues.""" - if not text: - return False - corrected = to_sentence_case(text) - return corrected != text - - -# --------------------------------------------------------------------------- -# Sidebar.ts label parsing -# --------------------------------------------------------------------------- - -def parse_sidebar_ts_labels() -> Dict[str, str]: - """Parse sidebar.ts to find { slug, label } overrides.""" - sidebar_path = DOCS_REPO / "src" / "sidebar.ts" - labels = {} - - if not sidebar_path.exists(): - return labels - - with open(sidebar_path) as f: - content = f.read() - - # Match patterns like: { slug: 'terminal/blocks', label: 'Overview' } - pattern = re.compile( - r"slug:\s*'([^']+)'\s*,\s*label:\s*'([^']+)'" - ) - for m in pattern.finditer(content): - labels[m.group(1)] = m.group(2) - - return labels - - -# --------------------------------------------------------------------------- -# Main audit -# --------------------------------------------------------------------------- - -def run_audit(): - issues = [] - info_rows = [] - - # Load sidebar.ts overrides - sidebar_ts_labels = parse_sidebar_ts_labels() - - # Parse all GitBook SUMMARY.md files - gitbook_nav: Dict[str, dict] = {} # astro_path -> {gitbook_label, gitbook_space} - - for space, prefix in GITBOOK_SPACES.items(): - summary_path = GITBOOK_REPO / space / "SUMMARY.md" - entries = parse_summary_md(summary_path) - - for gb_path, nav_label in entries.items(): - astro_path = gitbook_path_to_astro(gb_path, prefix) - if astro_path: - gitbook_nav[str(astro_path)] = { - "label": nav_label, - "space": space, - } - - # Scan all Astro MDX files - all_mdx = sorted(ASTRO_CONTENT.rglob("*.mdx")) - - for mdx_path in all_mdx: - fm = extract_frontmatter(mdx_path) - title = fm.get("title", "") - sidebar = fm.get("sidebar", {}) or {} - sidebar_label = sidebar.get("label", "") if isinstance(sidebar, dict) else "" - - # Determine the slug for sidebar.ts lookup - rel = mdx_path.relative_to(ASTRO_CONTENT) - slug = str(rel).replace("/index.mdx", "").replace(".mdx", "") - if slug == "index": - slug = "index" - - sidebar_ts_label = sidebar_ts_labels.get(slug, "") - - # Effective nav label (what actually shows in the sidebar) - if sidebar_ts_label: - effective_label = sidebar_ts_label - label_source = "sidebar.ts" - elif sidebar_label: - effective_label = sidebar_label - label_source = "frontmatter" - else: - effective_label = title - label_source = "title (fallback)" - - # GitBook nav label - gb_info = gitbook_nav.get(str(mdx_path)) - gb_label = gb_info["label"] if gb_info else "" - - rel_display = str(mdx_path.relative_to(DOCS_REPO)) - - # Check 1: Missing nav label override (GitBook had shorter label) - needs_label = False - recommended_label = "" - if gb_label and gb_label != title and label_source == "title (fallback)": - # GitBook had a different (usually shorter) label than the current title - needs_label = True - recommended_label = gb_label - - # Check 2: Sentence case issues in title - title_case_issue = has_sentence_case_issues(title) - corrected_title = to_sentence_case(title) if title_case_issue else "" - - # Check 3: Sentence case issues in effective nav label - label_case_issue = has_sentence_case_issues(effective_label) - corrected_label = to_sentence_case(effective_label) if label_case_issue else "" - - has_any_issue = needs_label or title_case_issue or label_case_issue - - if has_any_issue: - issue = { - "file": rel_display, - "title": title, - "effective_label": effective_label, - "label_source": label_source, - "gb_label": gb_label, - "needs_label": needs_label, - "recommended_label": recommended_label, - "title_case_issue": title_case_issue, - "corrected_title": corrected_title, - "label_case_issue": label_case_issue, - "corrected_label": corrected_label, - } - issues.append(issue) - - # Print report - print("=" * 80) - print("NAV LABEL & SENTENCE CASE AUDIT REPORT") - print("=" * 80) - - # Section 1: Missing nav label overrides - missing = [i for i in issues if i["needs_label"]] - print(f"\n## MISSING NAV LABELS ({len(missing)} pages)") - print("These pages had shorter nav labels in GitBook that weren't migrated.\n") - for i in missing: - print(f" {i['file']}") - print(f" Title (H1): {i['title']}") - print(f" GitBook nav label: {i['gb_label']}") - print(f" → Add sidebar.label: \"{i['recommended_label']}\"") - print() - - # Section 2: Sentence case issues in titles - title_issues = [i for i in issues if i["title_case_issue"]] - print(f"\n## TITLE SENTENCE CASE ISSUES ({len(title_issues)} pages)") - print("These titles don't follow sentence case rules.\n") - for i in title_issues: - print(f" {i['file']}") - print(f" Current: {i['title']}") - print(f" Suggested: {i['corrected_title']}") - print() - - # Section 3: Sentence case issues in nav labels - label_issues = [i for i in issues if i["label_case_issue"]] - print(f"\n## NAV LABEL SENTENCE CASE ISSUES ({len(label_issues)} pages)") - print("These nav labels don't follow sentence case rules.\n") - for i in label_issues: - print(f" {i['file']}") - print(f" Current ({i['label_source']}): {i['effective_label']}") - print(f" Suggested: {i['corrected_label']}") - print() - - # Summary - print("=" * 80) - print("SUMMARY") - print(f" Missing nav labels: {len(missing)}") - print(f" Title sentence case issues: {len(title_issues)}") - print(f" Label sentence case issues: {len(label_issues)}") - print(f" Total pages with issues: {len(issues)}") - print(f" Total pages scanned: {len(all_mdx)}") - print("=" * 80) - - return len(issues) - - -if __name__ == "__main__": - try: - import yaml - except ImportError: - print("Installing PyYAML...") - import subprocess - subprocess.check_call([sys.executable, "-m", "pip", "install", "pyyaml"]) - import yaml - - count = run_audit() - sys.exit(0 if count == 0 else 1) diff --git a/scripts/audit-report.txt b/scripts/audit-report.txt deleted file mode 100644 index 9ef900d..0000000 --- a/scripts/audit-report.txt +++ /dev/null @@ -1,1564 +0,0 @@ -================================================================================ -NAV LABEL & SENTENCE CASE AUDIT REPORT -================================================================================ - -## MISSING NAV LABELS (97 pages) -These pages had shorter nav labels in GitBook that weren't migrated. - - src/content/docs/agent-platform/cli-agents/overview.mdx - Title (H1): Third-Party CLI Agents - GitBook nav label: Overview - → Add sidebar.label: "Overview" - - src/content/docs/agent-platform/cloud-agents/deployment-patterns.mdx - Title (H1): Deployment Patterns - GitBook nav label: Deployment patterns - → Add sidebar.label: "Deployment patterns" - - src/content/docs/agent-platform/cloud-agents/faqs.mdx - Title (H1): Cloud Agent FAQs - GitBook nav label: Cloud agent FAQs - → Add sidebar.label: "Cloud agent FAQs" - - src/content/docs/agent-platform/cloud-agents/integrations/cloud-providers.mdx - Title (H1): Cloud Providers (Preview) - GitBook nav label: AWS, GCP, and other cloud providers - → Add sidebar.label: "AWS, GCP, and other cloud providers" - - src/content/docs/agent-platform/cloud-agents/integrations/demo-issue-triage-bot.mdx - Title (H1): Demo: Issue Triage Bot - GitBook nav label: Demo: Issue triage bot - → Add sidebar.label: "Demo: Issue triage bot" - - src/content/docs/agent-platform/cloud-agents/integrations/quickstart-github-actions.mdx - Title (H1): GitHub Actions quickstart - GitBook nav label: Quickstart - → Add sidebar.label: "Quickstart" - - src/content/docs/agent-platform/cloud-agents/integrations/quickstart.mdx - Title (H1): Integrations quickstart - GitBook nav label: Quickstart - → Add sidebar.label: "Quickstart" - - src/content/docs/agent-platform/cloud-agents/managing-cloud-agents.mdx - Title (H1): Managing Cloud Agents - GitBook nav label: Managing cloud agents - → Add sidebar.label: "Managing cloud agents" - - src/content/docs/agent-platform/cloud-agents/mcp.mdx - Title (H1): MCP Servers - GitBook nav label: MCP servers - → Add sidebar.label: "MCP servers" - - src/content/docs/agent-platform/cloud-agents/overview.mdx - Title (H1): Cloud Agents Overview - GitBook nav label: Cloud agents overview - → Add sidebar.label: "Cloud agents overview" - - src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx - Title (H1): Oz Web App - GitBook nav label: Oz web app - → Add sidebar.label: "Oz web app" - - src/content/docs/agent-platform/cloud-agents/platform.mdx - Title (H1): Oz Platform - GitBook nav label: Oz platform - → Add sidebar.label: "Oz platform" - - src/content/docs/agent-platform/cloud-agents/quickstart.mdx - Title (H1): Cloud Agents Quick Start - GitBook nav label: Quickstart - → Add sidebar.label: "Quickstart" - - src/content/docs/agent-platform/cloud-agents/self-hosting/managed-direct.mdx - Title (H1): Managed: Direct backend - GitBook nav label: Managed: Direct - → Add sidebar.label: "Managed: Direct" - - src/content/docs/agent-platform/cloud-agents/self-hosting/managed-docker.mdx - Title (H1): Managed: Docker backend - GitBook nav label: Managed: Docker - → Add sidebar.label: "Managed: Docker" - - src/content/docs/agent-platform/cloud-agents/self-hosting/managed-kubernetes.mdx - Title (H1): Managed: Kubernetes backend - GitBook nav label: Managed: Kubernetes - → Add sidebar.label: "Managed: Kubernetes" - - src/content/docs/agent-platform/cloud-agents/self-hosting/quickstart.mdx - Title (H1): Self-hosting quickstart - GitBook nav label: Quickstart - → Add sidebar.label: "Quickstart" - - src/content/docs/agent-platform/cloud-agents/self-hosting/troubleshooting.mdx - Title (H1): Self-hosting troubleshooting - GitBook nav label: Troubleshooting - → Add sidebar.label: "Troubleshooting" - - src/content/docs/agent-platform/cloud-agents/self-hosting/unmanaged.mdx - Title (H1): Unmanaged architecture - GitBook nav label: Unmanaged - → Add sidebar.label: "Unmanaged" - - src/content/docs/agent-platform/cloud-agents/skills-as-agents.mdx - Title (H1): Skills as Agents - GitBook nav label: Skills as agents - → Add sidebar.label: "Skills as agents" - - src/content/docs/agent-platform/cloud-agents/team-access-billing-and-identity.mdx - Title (H1): Access, billing, and identity permissions - GitBook nav label: Access, billing, and identity - → Add sidebar.label: "Access, billing, and identity" - - src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents-quickstart.mdx - Title (H1): Scheduled Agents quickstart - GitBook nav label: Quickstart - → Add sidebar.label: "Quickstart" - - src/content/docs/agent-platform/cloud-agents/triggers/scheduled-agents.mdx - Title (H1): Scheduled Agents - GitBook nav label: Scheduled agents - → Add sidebar.label: "Scheduled agents" - - src/content/docs/agent-platform/cloud-agents/viewing-cloud-agent-runs.mdx - Title (H1): Cloud agent session sharing - GitBook nav label: Viewing cloud agent runs - → Add sidebar.label: "Viewing cloud agent runs" - - src/content/docs/code/code-editor/code-editor-vim-keybindings.mdx - Title (H1): Code Editor Vim Keybindings - GitBook nav label: Code editor Vim keybindings - → Add sidebar.label: "Code editor Vim keybindings" - - src/content/docs/code/code-editor/find-and-replace.mdx - Title (H1): Find and Replace - GitBook nav label: Find & replace - → Add sidebar.label: "Find & replace" - - src/content/docs/code/git-worktrees.mdx - Title (H1): Git worktrees - GitBook nav label: Git Worktrees - → Add sidebar.label: "Git Worktrees" - - src/content/docs/enterprise/getting-started/getting-started-enterprise.mdx - Title (H1): Getting started with Warp Enterprise - GitBook nav label: Getting started for admins - → Add sidebar.label: "Getting started for admins" - - src/content/docs/enterprise/team-management/admin-panel.mdx - Title (H1): Admin Panel - GitBook nav label: Admin panel - → Add sidebar.label: "Admin panel" - - src/content/docs/getting-started/keyboard-shortcuts.mdx - Title (H1): Keyboard Shortcuts - GitBook nav label: Keyboard shortcuts - → Add sidebar.label: "Keyboard shortcuts" - - src/content/docs/getting-started/supported-shells.mdx - Title (H1): Supported Shells - GitBook nav label: Supported shells - → Add sidebar.label: "Supported shells" - - src/content/docs/knowledge-and-collaboration/warp-drive/agent-mode-context.mdx - Title (H1): Agent Mode Context - GitBook nav label: Agent Mode context - → Add sidebar.label: "Agent Mode context" - - src/content/docs/knowledge-and-collaboration/warp-drive/notebooks.mdx - Title (H1): Warp Drive Notebooks - GitBook nav label: Notebooks - → Add sidebar.label: "Notebooks" - - src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx - Title (H1): Warp Drive prompts - GitBook nav label: Prompts - → Add sidebar.label: "Prompts" - - src/content/docs/knowledge-and-collaboration/warp-drive/workflows.mdx - Title (H1): Warp Drive Workflows - GitBook nav label: Workflows - → Add sidebar.label: "Workflows" - - src/content/docs/reference/api-and-sdk/quickstart.mdx - Title (H1): API & SDK quickstart - GitBook nav label: Quickstart - → Add sidebar.label: "Quickstart" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/authentication-required.mdx - Title (H1): authentication_required - GitBook nav label: authentication\_required - → Add sidebar.label: "authentication\_required" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/budget-exceeded.mdx - Title (H1): budget_exceeded - GitBook nav label: budget\_exceeded - → Add sidebar.label: "budget\_exceeded" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/content-policy-violation.mdx - Title (H1): content_policy_violation - GitBook nav label: content\_policy\_violation - → Add sidebar.label: "content\_policy\_violation" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/environment-setup-failed.mdx - Title (H1): environment_setup_failed - GitBook nav label: environment\_setup\_failed - → Add sidebar.label: "environment\_setup\_failed" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/external-authentication-required.mdx - Title (H1): external_authentication_required - GitBook nav label: external\_authentication\_required - → Add sidebar.label: "external\_authentication\_required" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/feature-not-available.mdx - Title (H1): feature_not_available - GitBook nav label: feature\_not\_available - → Add sidebar.label: "feature\_not\_available" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/insufficient-credits.mdx - Title (H1): insufficient_credits - GitBook nav label: insufficient\_credits - → Add sidebar.label: "insufficient\_credits" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/integration-disabled.mdx - Title (H1): integration_disabled - GitBook nav label: integration\_disabled - → Add sidebar.label: "integration\_disabled" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/integration-not-configured.mdx - Title (H1): integration_not_configured - GitBook nav label: integration\_not\_configured - → Add sidebar.label: "integration\_not\_configured" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/internal-error.mdx - Title (H1): internal_error - GitBook nav label: internal\_error - → Add sidebar.label: "internal\_error" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/invalid-request.mdx - Title (H1): invalid_request - GitBook nav label: invalid\_request - → Add sidebar.label: "invalid\_request" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/not-authorized.mdx - Title (H1): not_authorized - GitBook nav label: not\_authorized - → Add sidebar.label: "not\_authorized" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/operation-not-supported.mdx - Title (H1): operation_not_supported - GitBook nav label: operation\_not\_supported - → Add sidebar.label: "operation\_not\_supported" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/resource-not-found.mdx - Title (H1): resource_not_found - GitBook nav label: resource\_not\_found - → Add sidebar.label: "resource\_not\_found" - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/resource-unavailable.mdx - Title (H1): resource_unavailable - GitBook nav label: resource\_unavailable - → Add sidebar.label: "resource\_unavailable" - - src/content/docs/reference/cli/agent-profiles.mdx - Title (H1): Agent profiles - GitBook nav label: Agent Profiles - → Add sidebar.label: "Agent Profiles" - - src/content/docs/reference/cli/api-keys.mdx - Title (H1): API keys - GitBook nav label: API Keys - → Add sidebar.label: "API Keys" - - src/content/docs/reference/cli/integration-setup.mdx - Title (H1): Integration setup - GitBook nav label: Integration Setup - → Add sidebar.label: "Integration Setup" - - src/content/docs/reference/cli/mcp-servers.mdx - Title (H1): MCP servers - GitBook nav label: MCP Servers - → Add sidebar.label: "MCP Servers" - - src/content/docs/reference/cli/quickstart.mdx - Title (H1): Quick Start - GitBook nav label: Quickstart - → Add sidebar.label: "Quickstart" - - src/content/docs/reference/cli/skills.mdx - Title (H1): Skills (CLI) - GitBook nav label: Skills - → Add sidebar.label: "Skills" - - src/content/docs/reference/cli/warp-drive.mdx - Title (H1): Warp Drive context - GitBook nav label: Warp Drive Context - → Add sidebar.label: "Warp Drive Context" - - src/content/docs/support-and-community/community/open-source-licenses.mdx - Title (H1): Open source licenses - GitBook nav label: Open Source Licenses - → Add sidebar.label: "Open Source Licenses" - - src/content/docs/support-and-community/community/refer-a-friend.mdx - Title (H1): Refer a friend and earn rewards - GitBook nav label: Refer a Friend & Earn Rewards - → Add sidebar.label: "Refer a Friend & Earn Rewards" - - src/content/docs/support-and-community/plans-and-billing/plans-pricing-refunds.mdx - Title (H1): Plans, pricing, and refunds - GitBook nav label: Plans, Pricing, & Refunds - → Add sidebar.label: "Plans, Pricing, & Refunds" - - src/content/docs/support-and-community/troubleshooting-and-support/logging-out-and-uninstalling.mdx - Title (H1): Logging out & uninstalling - GitBook nav label: Logging Out & Uninstalling - → Add sidebar.label: "Logging Out & Uninstalling" - - src/content/docs/support-and-community/troubleshooting-and-support/sending-us-feedback.mdx - Title (H1): Sending feedback and logs - GitBook nav label: Sending Feedback & Logs - → Add sidebar.label: "Sending Feedback & Logs" - - src/content/docs/terminal/appearance/blocks-behavior.mdx - Title (H1): Blocks Behavior - GitBook nav label: Blocks behavior - → Add sidebar.label: "Blocks behavior" - - src/content/docs/terminal/appearance/custom-themes.mdx - Title (H1): Custom Themes - GitBook nav label: Custom themes - → Add sidebar.label: "Custom themes" - - src/content/docs/terminal/appearance/pane-dimming.mdx - Title (H1): Pane Dimming & Focus - GitBook nav label: Pane dimming & focus - → Add sidebar.label: "Pane dimming & focus" - - src/content/docs/terminal/appearance/prompt.mdx - Title (H1): Terminal prompt - GitBook nav label: Prompt - → Add sidebar.label: "Prompt" - - src/content/docs/terminal/appearance/size-opacity-blurring.mdx - Title (H1): Size, Opacity, & Blurring - GitBook nav label: Size, opacity, & blurring - → Add sidebar.label: "Size, opacity, & blurring" - - src/content/docs/terminal/appearance/tabs-behavior.mdx - Title (H1): Tabs Behavior - GitBook nav label: Tabs behavior - → Add sidebar.label: "Tabs behavior" - - src/content/docs/terminal/appearance/text-fonts-cursor.mdx - Title (H1): Text, Fonts, & Cursor - GitBook nav label: Text, fonts, & cursor - → Add sidebar.label: "Text, fonts, & cursor" - - src/content/docs/terminal/appearance/themes.mdx - Title (H1): Terminal themes - GitBook nav label: Themes - → Add sidebar.label: "Themes" - - src/content/docs/terminal/blocks/background-blocks.mdx - Title (H1): Background Blocks - GitBook nav label: Background blocks - → Add sidebar.label: "Background blocks" - - src/content/docs/terminal/blocks/block-actions.mdx - Title (H1): Block Actions - GitBook nav label: Block actions - → Add sidebar.label: "Block actions" - - src/content/docs/terminal/blocks/block-basics.mdx - Title (H1): Terminal Block Basics - GitBook nav label: Block basics - → Add sidebar.label: "Block basics" - - src/content/docs/terminal/blocks/block-filtering.mdx - Title (H1): Block Filtering - GitBook nav label: Block filtering - → Add sidebar.label: "Block filtering" - - src/content/docs/terminal/blocks/block-sharing.mdx - Title (H1): Block Sharing - GitBook nav label: Block sharing - → Add sidebar.label: "Block sharing" - - src/content/docs/terminal/blocks/find.mdx - Title (H1): Terminal Block Find - GitBook nav label: Block find - → Add sidebar.label: "Block find" - - src/content/docs/terminal/editor/alias-expansion.mdx - Title (H1): Alias Expansion - GitBook nav label: Alias expansion - → Add sidebar.label: "Alias expansion" - - src/content/docs/terminal/editor/command-inspector.mdx - Title (H1): Command Inspector - GitBook nav label: Command inspector - → Add sidebar.label: "Command inspector" - - src/content/docs/terminal/editor/syntax-error-highlighting.mdx - Title (H1): Syntax & Error Highlighting - GitBook nav label: Syntax & error highlighting - → Add sidebar.label: "Syntax & error highlighting" - - src/content/docs/terminal/editor/vim.mdx - Title (H1): Input editor Vim keybindings - GitBook nav label: Vim keybindings - → Add sidebar.label: "Vim keybindings" - - src/content/docs/terminal/entry/command-corrections.mdx - Title (H1): Command Corrections - GitBook nav label: Command corrections - → Add sidebar.label: "Command corrections" - - src/content/docs/terminal/entry/command-history.mdx - Title (H1): Command History - GitBook nav label: Command history - → Add sidebar.label: "Command history" - - src/content/docs/terminal/entry/command-search.mdx - Title (H1): Command Search - GitBook nav label: Command search - → Add sidebar.label: "Command search" - - src/content/docs/terminal/entry/synchronized-inputs.mdx - Title (H1): Synchronized Inputs - GitBook nav label: Synchronized inputs - → Add sidebar.label: "Synchronized inputs" - - src/content/docs/terminal/entry/yaml-workflows.mdx - Title (H1): YAML Workflows - GitBook nav label: YAML workflows - → Add sidebar.label: "YAML workflows" - - src/content/docs/terminal/integrations-and-plugins.mdx - Title (H1): Terminal Integrations - GitBook nav label: Terminal integrations - → Add sidebar.label: "Terminal integrations" - - src/content/docs/terminal/more-features/files-and-links.mdx - Title (H1): Files, Links, & Scripts - GitBook nav label: Files, links, & scripts - → Add sidebar.label: "Files, links, & scripts" - - src/content/docs/terminal/more-features/markdown-viewer.mdx - Title (H1): Markdown Viewer - GitBook nav label: Markdown viewer - → Add sidebar.label: "Markdown viewer" - - src/content/docs/terminal/more-features/notifications.mdx - Title (H1): Desktop Notifications - GitBook nav label: Desktop notifications - → Add sidebar.label: "Desktop notifications" - - src/content/docs/terminal/more-features/settings-sync.mdx - Title (H1): Settings Sync - GitBook nav label: Settings Sync (Beta) - → Add sidebar.label: "Settings Sync (Beta)" - - src/content/docs/terminal/more-features/uri-scheme.mdx - Title (H1): Warp URI Scheme - GitBook nav label: Warp URI scheme - → Add sidebar.label: "Warp URI scheme" - - src/content/docs/terminal/more-features/working-directory.mdx - Title (H1): Working Directory - GitBook nav label: Working directory - → Add sidebar.label: "Working directory" - - src/content/docs/terminal/sessions/session-navigation.mdx - Title (H1): Session Navigation - GitBook nav label: Session navigation - → Add sidebar.label: "Session navigation" - - src/content/docs/terminal/sessions/session-restoration.mdx - Title (H1): Session Restoration - GitBook nav label: Session restoration - → Add sidebar.label: "Session restoration" - - src/content/docs/terminal/windows/global-hotkey.mdx - Title (H1): Global Hotkey - GitBook nav label: Global hotkey - → Add sidebar.label: "Global hotkey" - - src/content/docs/terminal/windows/vertical-tabs.mdx - Title (H1): Vertical tabs - GitBook nav label: Vertical Tabs - → Add sidebar.label: "Vertical Tabs" - - -## TITLE SENTENCE CASE ISSUES (166 pages) -These titles don't follow sentence case rules. - - src/content/docs/agent-platform/capabilities/agent-notifications.mdx - Current: Agent Notifications - Suggested: Agent notifications - - src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx - Current: Profiles & Permissions - Suggested: Profiles & permissions - - src/content/docs/agent-platform/capabilities/computer-use.mdx - Current: Computer Use - Suggested: Computer use - - src/content/docs/agent-platform/capabilities/full-terminal-use.mdx - Current: Full Terminal Use - Suggested: Full terminal use - - src/content/docs/agent-platform/capabilities/mcp.mdx - Current: Model Context Protocol (MCP) - Suggested: Model context protocol (MCP) - - src/content/docs/agent-platform/capabilities/task-lists.mdx - Current: Agent Task Lists - Suggested: Agent task lists - - src/content/docs/agent-platform/capabilities/web-search.mdx - Current: Web Search - Suggested: Web search - - src/content/docs/agent-platform/cli-agents/overview.mdx - Current: Third-Party CLI Agents - Suggested: Third-party CLI Agents - - src/content/docs/agent-platform/cli-agents/remote-control.mdx - Current: Remote Control - Suggested: Remote control - - src/content/docs/agent-platform/cloud-agents/deployment-patterns.mdx - Current: Deployment Patterns - Suggested: Deployment patterns - - src/content/docs/agent-platform/cloud-agents/integrations/cloud-providers.mdx - Current: Cloud Providers (Preview) - Suggested: Cloud providers (preview) - - src/content/docs/agent-platform/cloud-agents/integrations/demo-issue-triage-bot.mdx - Current: Demo: Issue Triage Bot - Suggested: Demo: issue triage bot - - src/content/docs/agent-platform/cloud-agents/integrations/index.mdx - Current: Integrations Overview - Suggested: Integrations overview - - src/content/docs/agent-platform/cloud-agents/managing-cloud-agents.mdx - Current: Managing Cloud Agents - Suggested: Managing cloud Agents - - src/content/docs/agent-platform/cloud-agents/mcp.mdx - Current: MCP Servers - Suggested: MCP servers - - src/content/docs/agent-platform/cloud-agents/overview.mdx - Current: Cloud Agents Overview - Suggested: Cloud Agents overview - - src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx - Current: Oz Web App - Suggested: Oz web app - - src/content/docs/agent-platform/cloud-agents/platform.mdx - Current: Oz Platform - Suggested: Oz platform - - src/content/docs/agent-platform/cloud-agents/quickstart.mdx - Current: Cloud Agents Quick Start - Suggested: Cloud Agents quick start - - src/content/docs/agent-platform/cloud-agents/self-hosting/managed-direct.mdx - Current: Managed: Direct backend - Suggested: Managed: direct backend - - src/content/docs/agent-platform/cloud-agents/viewing-cloud-agent-runs.mdx - Current: Cloud agent session sharing - Suggested: Cloud Agent session sharing - - src/content/docs/agent-platform/local-agents/active-ai.mdx - Current: Active AI Recommendations - Suggested: Active AI recommendations - - src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx - Current: Blocks as Context - Suggested: Blocks as context - - src/content/docs/agent-platform/local-agents/agent-context/images-as-context.mdx - Current: Images as Context - Suggested: Images as context - - src/content/docs/agent-platform/local-agents/agent-context/index.mdx - Current: Agent Context - Suggested: Agent context - - src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx - Current: Selection as Context - Suggested: Selection as context - - src/content/docs/agent-platform/local-agents/agent-context/urls-as-context.mdx - Current: URLs as Context - Suggested: Urls as context - - src/content/docs/agent-platform/local-agents/agent-context/using-to-add-context.mdx - Current: Using @ to Add Context - Suggested: Using @ to add context - - src/content/docs/agent-platform/local-agents/code-diffs.mdx - Current: Code Diffs - Suggested: Code diffs - - src/content/docs/agent-platform/local-agents/generate.mdx - Current: Generate (Legacy) - Suggested: Generate (legacy) - - src/content/docs/agent-platform/local-agents/interacting-with-agents/conversation-forking.mdx - Current: Conversation Forking - Suggested: Conversation forking - - src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx - Current: Agent Conversations - Suggested: Agent conversations - - src/content/docs/agent-platform/local-agents/session-sharing.mdx - Current: Agent Session Sharing - Suggested: Agent session sharing - - src/content/docs/code/code-editor/code-editor-vim-keybindings.mdx - Current: Code Editor Vim Keybindings - Suggested: Code editor Vim keybindings - - src/content/docs/code/code-editor/file-tree.mdx - Current: File Tree (Project Explorer) - Suggested: File tree (project explorer) - - src/content/docs/code/code-editor/find-and-replace.mdx - Current: Find and Replace - Suggested: Find and replace - - src/content/docs/code/code-editor/index.mdx - Current: Built-in Code Editor - Suggested: Built-in code editor - - src/content/docs/code/code-editor/language-server-protocol.mdx - Current: Language Server Protocol (LSP) - Suggested: Language server protocol (LSP) - - src/content/docs/enterprise/getting-started/getting-started-enterprise.mdx - Current: Getting started with Warp Enterprise - Suggested: Getting started with Warp enterprise - - src/content/docs/enterprise/security-and-compliance/sso.mdx - Current: Single Sign-On (SSO) - Suggested: Single sign-on (SSO) - - src/content/docs/enterprise/security-and-compliance/trust-center.mdx - Current: Trust Center - Suggested: Trust center - - src/content/docs/getting-started/keyboard-shortcuts.mdx - Current: Keyboard Shortcuts - Suggested: Keyboard shortcuts - - src/content/docs/getting-started/migrate-to-warp/migrate-to-warp-from-macos-terminal.mdx - Current: Migrate to Warp from macOS Terminal - Suggested: Migrate to Warp from macOS terminal - - src/content/docs/getting-started/supported-shells.mdx - Current: Supported Shells - Suggested: Supported shells - - src/content/docs/guides/agent-workflows/how-to-edit-agent-code-in-warp.mdx - Current: How to: Edit Agent Code in Warp - Suggested: How to: edit Agent code in Warp - - src/content/docs/guides/agent-workflows/how-to-explain-your-codebase-using-warp-rust-codebase.mdx - Current: How to: Explain Your Codebase Using Warp (Rust Codebase) - Suggested: How to: explain your codebase using Warp (rust codebase) - - src/content/docs/guides/agent-workflows/how-to-review-prs-like-a-senior-dev.mdx - Current: How To: Review PRs Like A Senior Dev - Suggested: How to: review PRs like a senior dev - - src/content/docs/guides/agent-workflows/how-to-run-3-agents-in-parallel-summarize-logs-analyze-pr-modify-ui.mdx - Current: How To: Run 3 Agents in Parallel (Summarize Logs + Analyze PR + Modify UI) - Suggested: How to: run 3 Agents in parallel (summarize logs + analyze PR + modify UI) - - src/content/docs/guides/agent-workflows/how-to-run-multiple-ai-coding-agents.mdx - Current: How to run multiple AI coding agents - Suggested: How to run multiple AI coding Agents - - src/content/docs/guides/agent-workflows/how-to-use-voice-and-images-to-prompt-coding-agents.mdx - Current: How to use voice and images to prompt coding agents - Suggested: How to use voice and images to Prompt coding Agents - - src/content/docs/guides/agent-workflows/running-multiple-agents-at-once-with-warp.mdx - Current: Running Multiple Agents At Once With Warp - Suggested: Running multiple Agents at once with Warp - - src/content/docs/guides/agent-workflows/understanding-your-codebase.mdx - Current: Understanding Your Codebase - Suggested: Understanding your codebase - - src/content/docs/guides/agent-workflows/using-images-as-context-with-warp.mdx - Current: Using Images As Context With Warp - Suggested: Using images as context with Warp - - src/content/docs/guides/agent-workflows/warp-for-product-managers.mdx - Current: 5 AI agent workflows for product managers - Suggested: 5 AI Agent Workflows for product managers - - src/content/docs/guides/build-an-app-in-warp/building-a-chrome-extension-d3js-javascript-html-css.mdx - Current: Building a Chrome Extension (D3.js + Javascript + HTML + CSS) - Suggested: Building a Chrome extension (D3.js + JavaScript + HTML + CSS) - - src/content/docs/guides/build-an-app-in-warp/building-a-real-time-chat-app-github-mcp-railway.mdx - Current: Building a Real-time Chat App (Github MCP + Railway ) - Suggested: Building a real-time chat app (GitHub MCP + Railway ) - - src/content/docs/guides/build-an-app-in-warp/building-warps-input-with-warp.mdx - Current: Building Warp's Input - With Warp - Suggested: Building Warp's input - with Warp - - src/content/docs/guides/configuration/creating-rules-for-agents.mdx - Current: Creating Rules For Agents - Suggested: Creating Rules for Agents - - src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx - Current: How To: Configure YOLO and Strategic Agent Profiles - Suggested: How to: configure YOLO and strategic Agent Profiles - - src/content/docs/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind.mdx - Current: How To: Create Project Rules for an Existing Project (Astro + Typescript + Tailwind) - Suggested: How to: create project Rules for an existing project (Astro + TypeScript + Tailwind) - - src/content/docs/guides/configuration/how-to-set-coding-best-practices.mdx - Current: How To: Set Coding Best Practices - Suggested: How to: set coding best practices - - src/content/docs/guides/configuration/how-to-set-coding-preferences-with-rules.mdx - Current: How To: Set Coding Preferences with Rules - Suggested: How to: set coding preferences with Rules - - src/content/docs/guides/configuration/how-to-set-tech-stack-preferences-with-rules.mdx - Current: How To: Set Tech Stack Preferences with Rules - Suggested: How to: set tech stack preferences with Rules - - src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx - Current: How to set up self-serve data analytics with Skills - Suggested: How to set up self-serve data analytics with skills - - src/content/docs/guides/configuration/how-to-sync-your-monorepos.mdx - Current: How To: Sync Your Monorepos - Suggested: How to: sync your monorepos - - src/content/docs/guides/configuration/how-to-use-agent-profiles-efficiently.mdx - Current: How To: Use Agent Profiles Efficiently - Suggested: How to: use Agent Profiles efficiently - - src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx - Current: Trigger Reusable Actions With Saved Prompts - Suggested: Trigger reusable actions with saved Prompts - - src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx - Current: How to: Analyze Cloud Run Logs (gcloud) - Suggested: How to: analyze cloud run logs (gcloud) - - src/content/docs/guides/devops/how-to-create-a-production-ready-docker-setup.mdx - Current: How To: Create a Production Ready Docker Setup - Suggested: How to: create a production ready Docker setup - - src/content/docs/guides/devops/how-to-create-priority-matrix-for-database-optimization.mdx - Current: How To: Create Priority Matrix for Database Optimization - Suggested: How to: create priority matrix for database optimization - - src/content/docs/guides/devops/how-to-generate-unit-and-security-tests-to-debug-faster.mdx - Current: How to: Generate Unit and Security Tests to Debug Faster - Suggested: How to: generate unit and security tests to debug faster - - src/content/docs/guides/devops/how-to-prevent-secrets-from-leaking.mdx - Current: How To: Prevent Secrets from Leaking - Suggested: How to: prevent secrets from leaking - - src/content/docs/guides/devops/how-to-write-sql-commands-inside-a-postgres-repl.mdx - Current: How To: Write SQL Commands inside a Postgres REPL - Suggested: How to: write SQL commands inside a Postgres REPL - - src/content/docs/guides/devops/improve-your-kubernetes-workflow-kubectl-helm.mdx - Current: Improve Your Kubernetes Workflow (kubectl + helm) - Suggested: Improve your Kubernetes Workflow (kubectl + Helm) - - src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx - Current: Context7 MCP: Update Astro Project with Best Practices - Suggested: Context7 MCP: update Astro project with best practices - - src/content/docs/guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch.mdx - Current: Figma Remote MCP: Create a Website from a Figma File from Scratch - Suggested: Figma remote MCP: create a website from a Figma file from scratch - - src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx - Current: Github MCP: Summarizing Open PRs & Creating GH Issues - Suggested: GitHub MCP: summarizing open PRs & creating gh issues - - src/content/docs/guides/external-tools/how-to-set-up-ollama.mdx - Current: How To Set Up Ollama - Suggested: How to set up Ollama - - src/content/docs/guides/external-tools/linear-mcp-retrieve-issue-data.mdx - Current: Linear MCP: Retrieve issue data - Suggested: Linear MCP: retrieve issue data - - src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx - Current: Linear MCP: Updating Tickets with a Lean Build Approach - Suggested: Linear MCP: updating tickets with a lean build approach - - src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx - Current: Puppeteer MCP: Scraping Amazon Web Reviews - Suggested: Puppeteer MCP: scraping Amazon web reviews - - src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx - Current: Sentry MCP: Fix Sentry Error in Empower Website - Suggested: Sentry MCP: fix Sentry error in empower website - - src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx - Current: SQLite and Stripe MCP: Basic Queries You Can Make After Set Up - Suggested: SQLite and Stripe MCP: basic queries you can make after set up - - src/content/docs/guides/external-tools/using-mcp-servers-with-warp.mdx - Current: Using MCP Servers with Warp - Suggested: Using MCP servers with Warp - - src/content/docs/guides/frontend/how-to-actually-code-ui-that-matches-your-mockup-react-tailwind.mdx - Current: How To: Actually Code UI That Matches Your Mockup (React + Tailwind) - Suggested: How to: actually code UI that matches your mockup (React + Tailwind) - - src/content/docs/guides/frontend/how-to-replace-a-ui-element-in-warp-rust-codebase.mdx - Current: How To: Replace A UI Element in Warp (Rust Codebase) - Suggested: How to: replace a UI element in Warp (rust codebase) - - src/content/docs/guides/getting-started/10-coding-features-you-should-know.mdx - Current: 10 Coding Features You Should Know - Suggested: 10 Coding features you should know - - src/content/docs/guides/getting-started/how-to-customize-warps-appearance.mdx - Current: How to: Customize Warp's Appearance - Suggested: How to: customize Warp's appearance - - src/content/docs/guides/getting-started/how-to-make-warps-ui-more-minimal.mdx - Current: How to Make Warp’s UI More Minimal - Suggested: How to make Warp’s UI more minimal - - src/content/docs/guides/getting-started/how-to-master-warps-code-review-panel.mdx - Current: How To Master Warp's Code Review Panel - Suggested: How to master Warp's Code Review panel - - src/content/docs/knowledge-and-collaboration/session-sharing/index.mdx - Current: Session Sharing - Suggested: Session sharing - - src/content/docs/knowledge-and-collaboration/warp-drive/agent-mode-context.mdx - Current: Agent Mode Context - Suggested: Agent Mode context - - src/content/docs/knowledge-and-collaboration/warp-drive/ai-objects.mdx - Current: AI-Integrated Objects - Suggested: AI-integrated objects - - src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.mdx - Current: Environment variables - Suggested: Environment Variables - - src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx - Current: Warp Drive prompts - Suggested: Warp Drive Prompts - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/authentication-required.mdx - Current: authentication_required - Suggested: Authentication_required - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/budget-exceeded.mdx - Current: budget_exceeded - Suggested: Budget_exceeded - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/conflict.mdx - Current: conflict - Suggested: Conflict - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/content-policy-violation.mdx - Current: content_policy_violation - Suggested: Content_policy_violation - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/environment-setup-failed.mdx - Current: environment_setup_failed - Suggested: Environment_setup_failed - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/external-authentication-required.mdx - Current: external_authentication_required - Suggested: External_authentication_required - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/feature-not-available.mdx - Current: feature_not_available - Suggested: Feature_not_available - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/index.mdx - Current: Errors Overview - Suggested: Errors overview - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/insufficient-credits.mdx - Current: insufficient_credits - Suggested: Insufficient_credits - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/integration-disabled.mdx - Current: integration_disabled - Suggested: Integration_disabled - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/integration-not-configured.mdx - Current: integration_not_configured - Suggested: Integration_not_configured - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/internal-error.mdx - Current: internal_error - Suggested: Internal_error - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/invalid-request.mdx - Current: invalid_request - Suggested: Invalid_request - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/not-authorized.mdx - Current: not_authorized - Suggested: Not_authorized - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/operation-not-supported.mdx - Current: operation_not_supported - Suggested: Operation_not_supported - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/resource-not-found.mdx - Current: resource_not_found - Suggested: Resource_not_found - - src/content/docs/reference/api-and-sdk/troubleshooting/errors/resource-unavailable.mdx - Current: resource_unavailable - Suggested: Resource_unavailable - - src/content/docs/reference/api-and-sdk/troubleshooting/index.mdx - Current: API Troubleshooting - Suggested: API troubleshooting - - src/content/docs/reference/cli/agent-profiles.mdx - Current: Agent profiles - Suggested: Agent Profiles - - src/content/docs/reference/cli/quickstart.mdx - Current: Quick Start - Suggested: Quick start - - src/content/docs/reference/cli/troubleshooting.mdx - Current: CLI Troubleshooting - Suggested: CLI troubleshooting - - src/content/docs/support-and-community/community/open-source-partnership.mdx - Current: Oz Open Source Partnership - Suggested: Oz open source partnership - - src/content/docs/support-and-community/community/warp-preview-and-alpha-program.mdx - Current: Warp Preview - Suggested: Warp preview - - src/content/docs/support-and-community/index.mdx - Current: Support & Community - Suggested: Support & community - - src/content/docs/support-and-community/plans-and-billing/bring-your-own-api-key.mdx - Current: Bring Your Own API Key - Suggested: Bring your own API key - - src/content/docs/support-and-community/plans-and-billing/overages-legacy.mdx - Current: Overages (Legacy) - Suggested: Overages (legacy) - - src/content/docs/support-and-community/privacy-and-security/network-log.mdx - Current: Network Log - Suggested: Network log - - src/content/docs/support-and-community/privacy-and-security/secret-redaction.mdx - Current: Secret Redaction - Suggested: Secret redaction - - src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx - Current: Known Issues - Suggested: Known issues - - src/content/docs/support-and-community/troubleshooting-and-support/troubleshooting-login-issues.mdx - Current: Troubleshooting Login - Suggested: Troubleshooting login - - src/content/docs/support-and-community/troubleshooting-and-support/using-warp-offline.mdx - Current: Using Warp Offline - Suggested: Using Warp offline - - src/content/docs/terminal/appearance/blocks-behavior.mdx - Current: Blocks Behavior - Suggested: Blocks behavior - - src/content/docs/terminal/appearance/custom-themes.mdx - Current: Custom Themes - Suggested: Custom themes - - src/content/docs/terminal/appearance/pane-dimming.mdx - Current: Pane Dimming & Focus - Suggested: Pane dimming & focus - - src/content/docs/terminal/appearance/prompt.mdx - Current: Terminal prompt - Suggested: Terminal Prompt - - src/content/docs/terminal/appearance/size-opacity-blurring.mdx - Current: Size, Opacity, & Blurring - Suggested: Size, opacity, & blurring - - src/content/docs/terminal/appearance/tabs-behavior.mdx - Current: Tabs Behavior - Suggested: Tabs behavior - - src/content/docs/terminal/appearance/text-fonts-cursor.mdx - Current: Text, Fonts, & Cursor - Suggested: Text, fonts, & Cursor - - src/content/docs/terminal/blocks/block-actions.mdx - Current: Block Actions - Suggested: Block actions - - src/content/docs/terminal/blocks/block-basics.mdx - Current: Terminal Block Basics - Suggested: Terminal Block basics - - src/content/docs/terminal/blocks/block-filtering.mdx - Current: Block Filtering - Suggested: Block filtering - - src/content/docs/terminal/blocks/block-sharing.mdx - Current: Block Sharing - Suggested: Block sharing - - src/content/docs/terminal/blocks/find.mdx - Current: Terminal Block Find - Suggested: Terminal Block find - - src/content/docs/terminal/blocks/sticky-command-header.mdx - Current: Sticky Command Header - Suggested: Sticky command header - - src/content/docs/terminal/command-completions/index.mdx - Current: Command Completions - Suggested: Command completions - - src/content/docs/terminal/editor/alias-expansion.mdx - Current: Alias Expansion - Suggested: Alias expansion - - src/content/docs/terminal/editor/command-inspector.mdx - Current: Command Inspector - Suggested: Command inspector - - src/content/docs/terminal/editor/index.mdx - Current: Modern Text Editing - Suggested: Modern text editing - - src/content/docs/terminal/editor/syntax-error-highlighting.mdx - Current: Syntax & Error Highlighting - Suggested: Syntax & error highlighting - - src/content/docs/terminal/entry/command-corrections.mdx - Current: Command Corrections - Suggested: Command corrections - - src/content/docs/terminal/entry/command-history.mdx - Current: Command History - Suggested: Command history - - src/content/docs/terminal/entry/command-search.mdx - Current: Command Search - Suggested: Command search - - src/content/docs/terminal/entry/index.mdx - Current: Command Entry - Suggested: Command entry - - src/content/docs/terminal/entry/synchronized-inputs.mdx - Current: Synchronized Inputs - Suggested: Synchronized inputs - - src/content/docs/terminal/input/classic-input.mdx - Current: Classic Input - Suggested: Classic input - - src/content/docs/terminal/input/universal-input.mdx - Current: Universal Input (Legacy) - Suggested: Universal Input (legacy) - - src/content/docs/terminal/integrations-and-plugins.mdx - Current: Terminal Integrations - Suggested: Terminal integrations - - src/content/docs/terminal/more-features/files-and-links.mdx - Current: Files, Links, & Scripts - Suggested: Files, links, & scripts - - src/content/docs/terminal/more-features/index.mdx - Current: More Features - Suggested: More features - - src/content/docs/terminal/more-features/markdown-viewer.mdx - Current: Markdown Viewer - Suggested: Markdown viewer - - src/content/docs/terminal/more-features/notifications.mdx - Current: Desktop Notifications - Suggested: Desktop notifications - - src/content/docs/terminal/more-features/settings-sync.mdx - Current: Settings Sync - Suggested: Settings sync - - src/content/docs/terminal/more-features/uri-scheme.mdx - Current: Warp URI Scheme - Suggested: Warp URI scheme - - src/content/docs/terminal/more-features/working-directory.mdx - Current: Working Directory - Suggested: Working directory - - src/content/docs/terminal/sessions/launch-configurations.mdx - Current: Launch Configurations (Legacy) - Suggested: Launch configurations (legacy) - - src/content/docs/terminal/sessions/session-navigation.mdx - Current: Session Navigation - Suggested: Session navigation - - src/content/docs/terminal/sessions/session-restoration.mdx - Current: Session Restoration - Suggested: Session restoration - - src/content/docs/terminal/settings/all-settings.mdx - Current: All settings reference - Suggested: All Settings reference - - src/content/docs/terminal/windows/global-hotkey.mdx - Current: Global Hotkey - Suggested: Global hotkey - - src/content/docs/terminal/windows/index.mdx - Current: Windows and Tabs - Suggested: Windows and tabs - - src/content/docs/terminal/windows/tab-configs.mdx - Current: Tab Configs - Suggested: Tab configs - - -## NAV LABEL SENTENCE CASE ISSUES (130 pages) -These nav labels don't follow sentence case rules. - - src/content/docs/agent-platform/capabilities/agent-notifications.mdx - Current (title (fallback)): Agent Notifications - Suggested: Agent notifications - - src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx - Current (title (fallback)): Profiles & Permissions - Suggested: Profiles & permissions - - src/content/docs/agent-platform/capabilities/computer-use.mdx - Current (title (fallback)): Computer Use - Suggested: Computer use - - src/content/docs/agent-platform/capabilities/full-terminal-use.mdx - Current (title (fallback)): Full Terminal Use - Suggested: Full terminal use - - src/content/docs/agent-platform/capabilities/mcp.mdx - Current (title (fallback)): Model Context Protocol (MCP) - Suggested: Model Context Protocol (MCP) - - src/content/docs/agent-platform/capabilities/task-lists.mdx - Current (title (fallback)): Agent Task Lists - Suggested: Agent task lists - - src/content/docs/agent-platform/capabilities/web-search.mdx - Current (title (fallback)): Web Search - Suggested: Web search - - src/content/docs/agent-platform/cli-agents/overview.mdx - Current (title (fallback)): Third-Party CLI Agents - Suggested: Third-party CLI agents - - src/content/docs/agent-platform/cloud-agents/deployment-patterns.mdx - Current (title (fallback)): Deployment Patterns - Suggested: Deployment patterns - - src/content/docs/agent-platform/cloud-agents/integrations/cloud-providers.mdx - Current (title (fallback)): Cloud Providers (Preview) - Suggested: Cloud providers (preview) - - src/content/docs/agent-platform/cloud-agents/integrations/demo-issue-triage-bot.mdx - Current (title (fallback)): Demo: Issue Triage Bot - Suggested: Demo: issue triage bot - - src/content/docs/agent-platform/cloud-agents/managing-cloud-agents.mdx - Current (title (fallback)): Managing Cloud Agents - Suggested: Managing cloud agents - - src/content/docs/agent-platform/cloud-agents/mcp.mdx - Current (title (fallback)): MCP Servers - Suggested: MCP servers - - src/content/docs/agent-platform/cloud-agents/overview.mdx - Current (title (fallback)): Cloud Agents Overview - Suggested: Cloud agents overview - - src/content/docs/agent-platform/cloud-agents/oz-web-app.mdx - Current (title (fallback)): Oz Web App - Suggested: Oz web app - - src/content/docs/agent-platform/cloud-agents/platform.mdx - Current (title (fallback)): Oz Platform - Suggested: Oz platform - - src/content/docs/agent-platform/cloud-agents/quickstart.mdx - Current (title (fallback)): Cloud Agents Quick Start - Suggested: Cloud agents quickstart - - src/content/docs/agent-platform/cloud-agents/viewing-cloud-agent-runs.mdx - Current (title (fallback)): Cloud agent session sharing - Suggested: Cloud agent session sharing - - src/content/docs/agent-platform/local-agents/active-ai.mdx - Current (title (fallback)): Active AI Recommendations - Suggested: Active AI recommendations - - src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx - Current (title (fallback)): Blocks as Context - Suggested: Blocks as context - - src/content/docs/agent-platform/local-agents/agent-context/images-as-context.mdx - Current (title (fallback)): Images as Context - Suggested: Images as context - - src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx - Current (title (fallback)): Selection as Context - Suggested: Selection as context - - src/content/docs/agent-platform/local-agents/agent-context/urls-as-context.mdx - Current (title (fallback)): URLs as Context - Suggested: URLs as context - - src/content/docs/agent-platform/local-agents/agent-context/using-to-add-context.mdx - Current (title (fallback)): Using @ to Add Context - Suggested: Using @ to add context - - src/content/docs/agent-platform/local-agents/code-diffs.mdx - Current (title (fallback)): Code Diffs - Suggested: Code diffs - - src/content/docs/agent-platform/local-agents/generate.mdx - Current (title (fallback)): Generate (Legacy) - Suggested: Generate (legacy) - - src/content/docs/agent-platform/local-agents/interacting-with-agents/conversation-forking.mdx - Current (title (fallback)): Conversation Forking - Suggested: Conversation forking - - src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx - Current (sidebar.ts): Agent Conversations - Suggested: Agent conversations - - src/content/docs/agent-platform/local-agents/session-sharing.mdx - Current (title (fallback)): Agent Session Sharing - Suggested: Agent session sharing - - src/content/docs/code/code-editor/code-editor-vim-keybindings.mdx - Current (title (fallback)): Code Editor Vim Keybindings - Suggested: Code editor Vim keybindings - - src/content/docs/code/code-editor/file-tree.mdx - Current (title (fallback)): File Tree (Project Explorer) - Suggested: File tree (project explorer) - - src/content/docs/code/code-editor/find-and-replace.mdx - Current (title (fallback)): Find and Replace - Suggested: Find and replace - - src/content/docs/enterprise/getting-started/getting-started-enterprise.mdx - Current (title (fallback)): Getting started with Warp Enterprise - Suggested: Getting started with Warp enterprise - - src/content/docs/getting-started/keyboard-shortcuts.mdx - Current (title (fallback)): Keyboard Shortcuts - Suggested: Keyboard shortcuts - - src/content/docs/getting-started/migrate-to-warp/migrate-to-warp-from-macos-terminal.mdx - Current (title (fallback)): Migrate to Warp from macOS Terminal - Suggested: Migrate to Warp from macOS terminal - - src/content/docs/getting-started/supported-shells.mdx - Current (title (fallback)): Supported Shells - Suggested: Supported shell - - src/content/docs/guides/configuration/how-to-configure-yolo-and-strategic-agent-profiles.mdx - Current (frontmatter): Configure YOLO and Strategic Agent Profiles - Suggested: Configure YOLO and strategic Agent Profiles - - src/content/docs/guides/configuration/how-to-create-project-rules-for-an-existing-project-astro-typescript-tailwind.mdx - Current (frontmatter): Create Project Rules for an existing project - Suggested: Create project Rules for an existing project - - src/content/docs/guides/configuration/how-to-set-up-self-serve-data-analytics-with-skills.mdx - Current (frontmatter): Set up self-serve data analytics with Skills - Suggested: Set up self-serve data analytics with skills - - src/content/docs/guides/configuration/trigger-reusable-actions-with-saved-prompts.mdx - Current (frontmatter): Trigger reusable actions with Saved Prompts - Suggested: Trigger reusable actions with saved prompts - - src/content/docs/guides/devops/how-to-analyze-cloud-run-logs-gcloud.mdx - Current (frontmatter): Analyze Cloud Run logs - Suggested: Analyze cloud run logs - - src/content/docs/guides/external-tools/context7-mcp-update-astro-project-with-best-practices.mdx - Current (frontmatter): Context7 MCP: Update Astro project with best practices - Suggested: Context7 MCP: update Astro project with best practices - - src/content/docs/guides/external-tools/figma-remote-mcp-create-a-website-from-a-figma-file-from-scratch.mdx - Current (frontmatter): Figma Remote MCP: Create a website from a Figma file from scratch - Suggested: Figma remote MCP: create a website from a Figma file - - src/content/docs/guides/external-tools/github-mcp-summarizing-open-prs-and-creating-gh-issues.mdx - Current (frontmatter): GitHub MCP: Summarize open PRs and create GitHub issues - Suggested: GitHub MCP: summarize open PRs and create GitHub issues - - src/content/docs/guides/external-tools/linear-mcp-retrieve-issue-data.mdx - Current (title (fallback)): Linear MCP: Retrieve issue data - Suggested: Linear MCP: retrieve issue data - - src/content/docs/guides/external-tools/linear-mcp-updating-tickets-with-a-lean-build-approach.mdx - Current (frontmatter): Linear MCP: Update tickets with a lean build approach - Suggested: Linear MCP: update tickets with a lean build approach - - src/content/docs/guides/external-tools/puppeteer-mcp-scraping-amazon-web-reviews.mdx - Current (frontmatter): Puppeteer MCP: Scrape Amazon web reviews - Suggested: Puppeteer MCP: scrape Amazon web reviews - - src/content/docs/guides/external-tools/sentry-mcp-fix-sentry-error-in-empower-website.mdx - Current (frontmatter): Sentry MCP: Fix Sentry error in Empower website - Suggested: Sentry MCP: fix Sentry error in empower website - - src/content/docs/guides/external-tools/sqlite-and-stripe-mcp-basic-queries-you-can-make-after-set-up.mdx - Current (frontmatter): SQLite and Stripe MCP: Basic queries you can make after setup - Suggested: SQLite and Stripe MCP: basic queries you can make after setup - - src/content/docs/knowledge-and-collaboration/session-sharing/index.mdx - Current (sidebar.ts): Session Sharing - Suggested: Session sharing - - src/content/docs/knowledge-and-collaboration/warp-drive/agent-mode-context.mdx - Current (title (fallback)): Agent Mode Context - Suggested: Agent Mode context - - src/content/docs/knowledge-and-collaboration/warp-drive/ai-objects.mdx - Current (title (fallback)): AI-Integrated Objects - Suggested: AI-integrated objects - - src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.mdx - Current (title (fallback)): Environment variables - Suggested: Environment Variables - - src/content/docs/reference/api-and-sdk/index.mdx - Current (sidebar.ts): Oz Agent API & SDK - Suggested: Oz agent API & SDK - - src/content/docs/reference/cli/agent-profiles.mdx - Current (title (fallback)): Agent profiles - Suggested: Agent Profiles - - src/content/docs/reference/cli/quickstart.mdx - Current (title (fallback)): Quick Start - Suggested: Quick start - - src/content/docs/reference/cli/troubleshooting.mdx - Current (title (fallback)): CLI Troubleshooting - Suggested: CLI troubleshooting - - src/content/docs/support-and-community/community/open-source-partnership.mdx - Current (title (fallback)): Oz Open Source Partnership - Suggested: Oz open source partnership - - src/content/docs/support-and-community/plans-and-billing/bring-your-own-api-key.mdx - Current (title (fallback)): Bring Your Own API Key - Suggested: Bring your own API key - - src/content/docs/support-and-community/plans-and-billing/overages-legacy.mdx - Current (title (fallback)): Overages (Legacy) - Suggested: Overages (legacy) - - src/content/docs/support-and-community/privacy-and-security/network-log.mdx - Current (title (fallback)): Network Log - Suggested: Network log - - src/content/docs/support-and-community/privacy-and-security/secret-redaction.mdx - Current (title (fallback)): Secret Redaction - Suggested: Secret redaction - - src/content/docs/support-and-community/troubleshooting-and-support/known-issues.mdx - Current (title (fallback)): Known Issues - Suggested: Known issues - - src/content/docs/support-and-community/troubleshooting-and-support/troubleshooting-login-issues.mdx - Current (title (fallback)): Troubleshooting Login - Suggested: Troubleshooting login - - src/content/docs/support-and-community/troubleshooting-and-support/using-warp-offline.mdx - Current (title (fallback)): Using Warp Offline - Suggested: Using Warp offline - - src/content/docs/terminal/appearance/blocks-behavior.mdx - Current (title (fallback)): Blocks Behavior - Suggested: Blocks behavior - - src/content/docs/terminal/appearance/custom-themes.mdx - Current (title (fallback)): Custom Themes - Suggested: Custom themes - - src/content/docs/terminal/appearance/pane-dimming.mdx - Current (title (fallback)): Pane Dimming & Focus - Suggested: Pane dimming & focus - - src/content/docs/terminal/appearance/size-opacity-blurring.mdx - Current (title (fallback)): Size, Opacity, & Blurring - Suggested: Size, opacity, & blurring - - src/content/docs/terminal/appearance/tabs-behavior.mdx - Current (title (fallback)): Tabs Behavior - Suggested: Tabs behavior - - src/content/docs/terminal/appearance/text-fonts-cursor.mdx - Current (title (fallback)): Text, Fonts, & Cursor - Suggested: Text, fonts, & cursor - - src/content/docs/terminal/blocks/block-actions.mdx - Current (title (fallback)): Block Actions - Suggested: Block actions - - src/content/docs/terminal/blocks/block-basics.mdx - Current (title (fallback)): Terminal Block Basics - Suggested: Block basics - - src/content/docs/terminal/blocks/block-filtering.mdx - Current (title (fallback)): Block Filtering - Suggested: Block filtering - - src/content/docs/terminal/blocks/block-sharing.mdx - Current (title (fallback)): Block Sharing - Suggested: Block sharing - - src/content/docs/terminal/blocks/find.mdx - Current (title (fallback)): Terminal Block Find - Suggested: Block find - - src/content/docs/terminal/editor/alias-expansion.mdx - Current (title (fallback)): Alias Expansion - Suggested: Alias expansion - - src/content/docs/terminal/editor/command-inspector.mdx - Current (title (fallback)): Command Inspector - Suggested: Command inspector - - src/content/docs/terminal/editor/syntax-error-highlighting.mdx - Current (title (fallback)): Syntax & Error Highlighting - Suggested: Syntax & error highlighting - - src/content/docs/terminal/entry/command-corrections.mdx - Current (title (fallback)): Command Corrections - Suggested: Command corrections - - src/content/docs/terminal/entry/command-history.mdx - Current (title (fallback)): Command History - Suggested: Command history - - src/content/docs/terminal/entry/command-search.mdx - Current (title (fallback)): Command Search - Suggested: Command search - - src/content/docs/terminal/entry/synchronized-inputs.mdx - Current (title (fallback)): Synchronized Inputs - Suggested: Synchronized inputs - - src/content/docs/terminal/input/classic-input.mdx - Current (title (fallback)): Classic Input - Suggested: Classic input - - src/content/docs/terminal/input/universal-input.mdx - Current (title (fallback)): Universal Input (Legacy) - Suggested: Universal Input (legacy) - - src/content/docs/terminal/integrations-and-plugins.mdx - Current (title (fallback)): Terminal Integrations - Suggested: Terminal integrations - - src/content/docs/terminal/more-features/files-and-links.mdx - Current (title (fallback)): Files, Links, & Scripts - Suggested: Files, links, & scripts - - src/content/docs/terminal/more-features/markdown-viewer.mdx - Current (title (fallback)): Markdown Viewer - Suggested: Markdown viewer - - src/content/docs/terminal/more-features/notifications.mdx - Current (title (fallback)): Desktop Notifications - Suggested: Desktop notifications - - src/content/docs/terminal/more-features/settings-sync.mdx - Current (title (fallback)): Settings Sync - Suggested: Settings sync - - src/content/docs/terminal/more-features/uri-scheme.mdx - Current (title (fallback)): Warp URI Scheme - Suggested: Warp URI scheme - - src/content/docs/terminal/more-features/working-directory.mdx - Current (title (fallback)): Working Directory - Suggested: Working directory - - src/content/docs/terminal/sessions/launch-configurations.mdx - Current (title (fallback)): Launch Configurations (Legacy) - Suggested: Launch configurations (legacy) - - src/content/docs/terminal/sessions/session-navigation.mdx - Current (title (fallback)): Session Navigation - Suggested: Session navigation - - src/content/docs/terminal/sessions/session-restoration.mdx - Current (title (fallback)): Session Restoration - Suggested: Session restoration - - src/content/docs/terminal/settings/all-settings.mdx - Current (title (fallback)): All settings reference - Suggested: All Settings reference - - src/content/docs/terminal/windows/global-hotkey.mdx - Current (title (fallback)): Global Hotkey - Suggested: Global hotkey - - src/content/docs/terminal/windows/tab-configs.mdx - Current (title (fallback)): Tab Configs - Suggested: Tab configs - -================================================================================ -SUMMARY - Missing nav labels: 97 - Title sentence case issues: 166 - Label sentence case issues: 130 - Total pages with issues: 199 - Total pages scanned: 306 -================================================================================