diff --git a/.agents/references/terminology.md b/.agents/references/terminology.md
index 3768d96..aea79cf 100644
--- a/.agents/references/terminology.md
+++ b/.agents/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/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 6403b66..84fbfe0 100644
--- a/src/content/docs/agent-platform/cli-agents/overview.mdx
+++ b/src/content/docs/agent-platform/cli-agents/overview.mdx
@@ -1,8 +1,10 @@
---
-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.
+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..dd242d5 100644
--- a/src/content/docs/agent-platform/cloud-agents/overview.mdx
+++ b/src/content/docs/agent-platform/cloud-agents/overview.mdx
@@ -1,14 +1,16 @@
---
-title: Cloud Agents Overview
+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';
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.
@@ -142,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/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..7913c03 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';
@@ -11,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 e2e3ce9..a8d1def 100644
--- a/src/content/docs/agent-platform/cloud-agents/quickstart.mdx
+++ b/src/content/docs/agent-platform/cloud-agents/quickstart.mdx
@@ -1,9 +1,11 @@
---
-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
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.
@@ -99,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/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/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/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/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/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/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/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/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.
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..7b0d9ed 100644
--- a/src/content/docs/getting-started/supported-shells.mdx
+++ b/src/content/docs/getting-started/supported-shells.mdx
@@ -1,9 +1,10 @@
---
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:
+ 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/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 9a9074f..97db4c3 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:
@@ -18,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/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..de2a145 100644
--- a/src/content/docs/reference/cli/quickstart.mdx
+++ b/src/content/docs/reference/cli/quickstart.mdx
@@ -1,7 +1,9 @@
---
-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:
+ 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 9336401..652a81c 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"
---
```text
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/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/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/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/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/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/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/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/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..5d340fc 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';
@@ -14,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
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/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/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/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/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/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/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.
diff --git a/src/content/docs/terminal/windows/vertical-tabs.mdx b/src/content/docs/terminal/windows/vertical-tabs.mdx
index b07bf1c..0923dc6 100644
--- a/src/content/docs/terminal/windows/vertical-tabs.mdx
+++ b/src/content/docs/terminal/windows/vertical-tabs.mdx
@@ -1,10 +1,11 @@
---
-title: Vertical tabs
+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.
+ 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.