Add AEO citation blocks (40-60 word summaries) to key pages

src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx

@@ -6,6 +6,8 @@ description: >-
 ---
 import { Tabs, TabItem } from '@astrojs/starlight/components';
 
+Agent Profiles let you configure how Warp's agents behave in different situations, including autonomy level, base model, tool access, and command permissions. Create multiple profiles for different workflows, control which commands run automatically, and set MCP server access rules per profile.
+
 ## Agent Profiles
 
 Agent Profiles let you configure how your Agent behaves in different situations. Each profile defines the Agent's autonomy, base models, and tool access. You can create multiple profiles and edit them directly in **Settings** > **Agents** > **Profiles**.

src/content/docs/agent-platform/capabilities/full-terminal-use.mdx

@@ -7,7 +7,7 @@ description: >-
 import { Tabs, TabItem } from '@astrojs/starlight/components';
 import VideoEmbed from '@components/VideoEmbed.astro';
 
-Full Terminal Use lets Warp's agent operate directly inside interactive terminal applications, such as database shells, debuggers, text editors, long-running servers, and more.
+Full Terminal Use lets Warp's agent operate directly inside interactive terminal applications like database shells, debuggers, text editors, and long-running servers. The agent can see the live terminal buffer, write commands, respond to prompts, and hand control back to you at any time.
 
 The agent can see the live terminal buffer (terminal state), write to the PTY to run commands, respond to prompts, and continue working inside the running process while you stay in control.
 

src/content/docs/agent-platform/capabilities/index.mdx

@@ -5,9 +5,7 @@ description: >-
   what context they have access to, and how they execute tasks.
 ---
 
-These capabilities are the foundational building blocks that define how agents operate. These include the context sources agents can access, the rules that guide their behavior, and the tools they can use.
-
-Understanding these capabilities helps you get the most out of agents by configuring them to match your workflows and preferences.
+Agent capabilities are the core building blocks that define how Warp's agents operate, including the context sources agents can access, the rules that guide their behavior, the tools they can use, and the models they run on. Configure these capabilities to match your workflows and preferences.
 
 ## Capabilities in this section
 

src/content/docs/agent-platform/capabilities/model-choice.mdx

@@ -7,6 +7,8 @@ description: >-
   auto-select the best model).
 ---
 
+Warp lets you choose from a curated set of large language models to power your agents, or let Warp auto-select the best model for each task. Models from OpenAI, Anthropic, Google, and open source providers are available, with configurable reasoning levels and per-profile defaults.
+
 ## Available models
 
 Warp lets you choose from a curated set of Large Language Models (LLMs) to power your Agentic Development Environment.

src/content/docs/agent-platform/capabilities/slash-commands.mdx

@@ -5,7 +5,7 @@ description: >-
   built-in actions or saved prompts without leaving the input field.
 ---
 
-When using Agent Mode or Auto-Detection Mode, typing `/` in the input field opens the Slash Commands menu.
+Slash Commands are quick actions and saved prompts you can invoke by typing `/` in Agent Mode or Auto-Detection Mode. They provide instant access to built-in actions like starting conversations, creating environments, switching models, and running saved prompts from Warp Drive.
 
 <figure>
 ![Slash Commands menu](../../../../assets/agent-platform/slash-commands-menu.png)

src/content/docs/agent-platform/capabilities/task-lists.mdx

@@ -6,9 +6,7 @@ description: >-
   time.
 ---
 
-The Agent can automatically break down complex requests into clear, trackable steps in the form of a task list with to-do items.\
-\
-When you make a sufficiently complex request that requires multiple actions, the Agent will automatically create a list of steps, execute them in order, and track progress from start to finish. There’s no need to adjust settings or enable a special mode—the Agent detects and creates task lists automatically.
+Task Lists let Warp's agent automatically break down complex requests into clear, trackable steps. When a request requires multiple actions, the agent creates a structured list, executes each step in order, and tracks progress in real time. No configuration is needed—the agent detects and creates task lists automatically.
 
 <figure>
 ![An example of a task list in progress.](../../../../assets/agent-platform/in-progress-tasklist.png)

src/content/docs/agent-platform/cloud-agents/integrations/cloud-providers.mdx

@@ -6,11 +6,7 @@ sidebar:
   label: "AWS, GCP, and other cloud providers"
 ---
 
-Cloud agents can securely access cloud providers using short-lived OpenID Connect credentials.
-
-This page explains how to configure a cloud agent environment to automatically authenticate to your
-cloud provider. Oz has built-in support for AWS and GCP, and can work with any provider that
-supports OIDC tokens.
+Cloud agents can securely access AWS, GCP, and other cloud providers using short-lived OpenID Connect (OIDC) credentials. Configure your cloud agent environment to automatically authenticate to your cloud provider without storing long-lived keys, using Warp's built-in OIDC federation support.
 
 ---
 

src/content/docs/agent-platform/cloud-agents/integrations/demo-issue-triage-bot.mdx

@@ -8,6 +8,8 @@ sidebar:
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
+This demo shows how to trigger Warp's coding agent from a GitHub Action to automate bug report handling. The agent evaluates whether a report is actionable, requests missing details when needed, and escalates directly into a draft pull request when the issue is ready for a fix.
+
 <VideoEmbed url="https://www.youtube.com/watch?feature=youtu.be&v=dK2eohQ2Yow" />
 
 :::note

src/content/docs/agent-platform/cloud-agents/integrations/slack.mdx

@@ -7,6 +7,8 @@ description: >-
   pull requests.
 ---
 
+The Slack integration lets your team trigger Oz cloud agents directly from Slack conversations. Tag @Oz in a message or DM the bot to start a cloud agent that clones your repos, works through the task, posts progress updates, and opens pull requests back into the same thread.
+
 ### Overview
 
 The Slack integration lets your team trigger agents directly from conversations in Slack. When you tag **@Oz** in a message or DM the bot, Warp will start an agent in the cloud, clone the repositories defined in your environment, and begin working through the task with full context from your codebase and the Slack thread.

src/content/docs/agent-platform/cloud-agents/overview.mdx

@@ -8,7 +8,7 @@ sidebar:
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
-Cloud agents are **cloud-connected**, **background agents** that run on the [Oz Platform](/agent-platform/cloud-agents/platform/).
+Cloud agents are autonomous, background agents that run on Warp's cloud infrastructure or your own, triggered by system events, schedules, or integrations like Slack and GitHub. They execute tasks with full observability — every run is tracked, auditable, and shareable across your team.
 
 **New to cloud agents?** Start with the [Cloud agents quickstart](/agent-platform/cloud-agents/quickstart/) to run your first cloud agent in ~10 minutes.
 

src/content/docs/agent-platform/getting-started/agents-in-warp.mdx

@@ -6,6 +6,8 @@ description: >-
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
+Warp includes Oz agents that help you write code, debug issues, and complete terminal workflows from natural language prompts. Agents operate with full context from your codebase, Warp Drive, and connected tools while you control their autonomy, permissions, and model choices.
+
 <VideoEmbed url="https://youtu.be/qiQtD1jPF6s" title="Agent Mode Overview" />
 
 Warp includes powerful coding agents designed to help you build, test, deploy, and debug while keeping you in control. Describe what you want to do in natural language (_you can even use your voice_), and the agent will take action using your environment, codebase, and saved context.

src/content/docs/agent-platform/getting-started/faqs.mdx

@@ -7,6 +7,8 @@ description: >-
   models, privacy practices, credit limits, billing, and usage guidelines.
 ---
 
+Answers to frequently asked questions about Warp's agents, including supported models, data privacy, credit limits, billing, and common error messages. For billing-specific questions, see the pricing FAQs.
+
 ## General
 
 ### What data is sent and/or stored when using Agents in Warp?

src/content/docs/agent-platform/index.mdx

@@ -5,7 +5,7 @@ description: >-
   and autonomous agents for development workflows.
 ---
 
-Warp includes **Oz**, the orchestration platform for cloud agents. While Warp provides the terminal and coding surface you work in day-to-day, Oz is the underlying orchestration layer that makes running agents at scale possible.
+Warp includes **Oz**, the orchestration platform that powers all of Warp's agents. Oz runs interactive agents locally inside Warp for real-time coding assistance and deploys autonomous agents in the cloud for background automation, event-driven workflows, and parallel execution across repos and teams.
 
 Warp's client is open source under [AGPL v3](https://github.com/warpdotdev/warp/blob/master/LICENSE-AGPL), so the editor and terminal that host your agents are fully auditable. See [Contributing to Warp](/support-and-community/community/contributing/) for the source and contribution flow.
 

src/content/docs/agent-platform/local-agents/active-ai.mdx

@@ -5,6 +5,8 @@ description: >-
   on your command line errors, inputs, and outputs.
 ---
 
+Active AI Recommendations proactively suggest fixes and next actions based on your terminal errors, inputs, and outputs. Features include Prompt Suggestions that activate Agent Mode, Next Command predictions from your shell history, and Suggested Code Diffs that automatically surface fixes for command-line errors.
+
 :::note
 Active AI features can be disabled in **Settings** > **Agents** > **Warp Agent** with the Active AI toggle.
 :::

src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx

@@ -6,6 +6,8 @@ description: >-
 ---
 import { Tabs, TabItem } from '@astrojs/starlight/components';
 
+Attach terminal output blocks to your agent prompts so the agent can understand errors, commands, and outputs from your current or previous sessions. Blocks can be attached with keyboard shortcuts, mouse clicks, or automatically within agent conversations.
+
 ## Attaching blocks as context
 
 Warp’s Agent can use blocks from your Agent conversations as context to better understand your queries and generate more relevant responses.

src/content/docs/agent-platform/local-agents/agent-context/images-as-context.mdx

@@ -5,6 +5,8 @@ description: >-
   can use visual context when generating responses.
 ---
 
+Attach screenshots, diagrams, or other images directly to agent prompts so the agent can use visual context when generating responses. Warp supports drag-and-drop, copy-paste, and file upload for up to 5 images per request across all supported models.
+
 ## **Attaching images as context**
 
 To provide visual context, you can attach images directly to an agent prompt. This is useful for including screenshots, diagrams, or other visual references alongside your query.

src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx

@@ -5,6 +5,8 @@ description: >-
   context for your Agent prompts.
 ---
 
+Attach text selections or diff hunks directly from Warp's code editor or Code Review panel as context for agent prompts. Select code, press a keyboard shortcut, and Warp inserts the file path, line numbers, and content into your prompt automatically.
+
 ### Attaching selections from Warp's native code editor
 
 When you have Warp’s [native code editor](/code/code-editor/) open beside a regular pane, you can easily attach specific lines of code as context:

src/content/docs/agent-platform/local-agents/agent-context/urls-as-context.mdx

@@ -5,6 +5,8 @@ description: >-
   content.
 ---
 
+Attach a public URL to any agent prompt to provide page content as context. Warp scrapes the page and surfaces the extracted text directly to the model, giving the agent access to documentation, references, or any publicly accessible web content.
+
 ## Referencing websites via URLs
 
 You can attach a public URL to any prompt to provide page content as context. Warp will scrape the page and surface the extracted text directly to the model.

src/content/docs/agent-platform/local-agents/agent-context/using-to-add-context.mdx

@@ -6,6 +6,8 @@ description: >-
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
+Use the @ symbol in agent prompts to reference files, folders, code symbols, Warp Drive objects, and blocks from other sessions as context. The @ menu searches your entire Git repository from the project root and works immediately without codebase indexing.
+
 ## How the @ context menu works
 
 You can attach specific files, folders, code symbols, Warp Drive objects, and blocks from other sessions as context to a prompt using the @ symbol. When you’re inside a **Git repository**, typing @ opens a context menu that allows you to search for and select files or directories to include.

src/content/docs/agent-platform/local-agents/code-diffs.mdx

@@ -8,6 +8,8 @@ description: >-
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
+When Warp's agent generates code changes, they appear as visual diffs in a built-in editor. Review proposed changes line by line, refine them with natural language, make manual edits, or accept them to apply the modifications to your files.
+
 ## Reviewing code diffs
 
 During an Agent Conversation, Warp can generate code diffs that open directly in a built-in diff editor.

src/content/docs/agent-platform/local-agents/generate.mdx

@@ -8,6 +8,8 @@ description: >-
 import { Tabs, TabItem } from '@astrojs/starlight/components';
 import VideoEmbed from '@components/VideoEmbed.astro';
 
+Generate (Legacy) turns natural language queries into precise terminal commands or contextual suggestions inside interactive CLI tools. Type `#` in the command line to describe what you want, and Warp generates the matching command in real time.
+
 ## What is Generate?
 
 Generate helps turn natural language queries into precise commands as terminal input or contextual suggestions inside interactive commands and programs, whether you're using psql, gdb, git, mysql, or any other CLI tool.

src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx

@@ -7,6 +7,8 @@ description: >-
 import { Tabs, TabItem } from '@astrojs/starlight/components';
 import VideoEmbed from '@components/VideoEmbed.astro';
 
+Agent conversations in Warp are multi-turn interactions tied to terminal sessions. Continue previous threads with follow-ups, manage conversation history, attach context from blocks and files, and run multiple conversations simultaneously across windows, tabs, or panes.
+
 ## Conversations with Warp's Agent
 
 Conceptually, a conversation is a sequence of AI queries and blocks. Conversations are tied to sessions and you can run multiple Agent Mode conversations simultaneously in different windows, tabs, or panes.

src/content/docs/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx

@@ -6,7 +6,7 @@ description: >-
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
-Warp provides two distinct modes: a clean terminal for commands, and a dedicated conversation view for multi-turn conversations with [Oz, Warp's agent](/agent-platform/local-agents/interacting-with-agents/).
+Warp provides two distinct modes: a clean terminal for running shell commands, and a dedicated conversation view for multi-turn interactions with Oz, Warp's agent. Terminal mode keeps the interface minimal by default, while Agent Mode surfaces full controls for model selection, voice input, image attachments, and conversation management.
 
 <VideoEmbed url="https://youtu.be/J715YW5VC18" />
 

src/content/docs/agent-platform/local-agents/interactive-code-review.mdx

@@ -6,6 +6,8 @@ description: >-
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
+Interactive Code Review lets you review agent-generated code, leave inline comments on specific lines, batch your feedback, and send all requested changes to the agent in a single pass. It works with Warp's native agent and supported third-party CLI agents like Claude Code and Codex.
+
 ### Overview
 
 Interactive Code Review lets you review, annotate, and refine code generated by any supported agent, whether that's Warp's native Agent or a third-party CLI agent running in Warp. Instead of relying on an AI to review another AI's output, Warp keeps the developer in control.

src/content/docs/agent-platform/local-agents/overview.mdx

@@ -6,6 +6,8 @@ description: >-
   Environment.
 ---
 
+Warp's local agents are interactive agents embedded directly in the terminal that help you write code, debug issues, run commands, and automate development tasks using natural language. Agents operate with full context from your codebase, Warp Drive, and connected tools, while you stay in control of every action.
+
 ## AI in Warp
 
 Warp includes intelligent agents designed to help you build, test, deploy, and debug while keeping you in control. Interactive agent conversations in Warp can look up commands, execute tasks, fix bugs, and adapt to your workflows. You can manage agent behavior directly, with full context from your Warp Drive and your team.

src/content/docs/code/code-editor/code-editor-vim-keybindings.mdx

@@ -7,6 +7,8 @@ sidebar:
   label: "Code editor Vim keybindings"
 ---
 
+Warp's built-in code editor supports native Vim keybindings for keyboard-driven navigation and editing. Enable Vim mode to use familiar motions, text objects, visual mode, registers, and editing commands directly in Warp without switching to an external editor.
+
 ## About Vim keybindings
 
 The Vi family of programs (including Vim and Neovim) are modal text editors that allow for keyboard-driven text editing. Vi-style keybindings are especially popular among developers for their speed and precision in navigating and manipulating code. Warp’s [code editor](/code/code-editor/) now includes native support for Vim keybindings (also known as Vim mode), offering a familiar editing experience directly within your coding workflows.

src/content/docs/code/code-editor/file-tree.mdx

@@ -5,6 +5,8 @@ description: >-
   context menu actions.
 ---
 
+The File Tree is Warp's built-in project explorer for browsing, opening, and managing files alongside your terminal. It automatically reflects your project structure and supports context menu actions like attaching files as agent context, copying paths, and creating new files.
+
 ![Warp's native file tree showing the project's file and folder structure in the left panel.](../../../../assets/terminal/filetree-main.png)
 
 Warp includes a **native file tree** that makes it easy to explore and manage project files. The file tree is available whenever in any directory and it automatically reflects your project structure as files are added, removed, or changed.

src/content/docs/code/code-editor/find-and-replace.mdx

@@ -8,6 +8,8 @@ sidebar:
 ---
 import DemoVideo from '@components/DemoVideo.astro';
 
+Warp's code editor includes built-in find and replace with support for regex, case sensitivity, and smart case preservation. Search across a file, jump between matches, and replace text with automatic casing adjustments for PascalCase, camelCase, and hyphenated patterns.
+
 ## Find
 
 Press `CMD-F` on macOS or `CTRL-SHIFT-F` on Windows and Linux to open the find menu. As you type, all matches in the file are highlighted, and the match closest to your cursor is selected.

src/content/docs/code/code-review.mdx

@@ -7,6 +7,8 @@ description: >-
 import DemoVideo from '@components/DemoVideo.astro';
 import VideoEmbed from '@components/VideoEmbed.astro';
 
+The Code Review panel lets you inspect, edit, and manage Git diffs directly inside Warp. Review uncommitted changes or compare branches, attach diffs as context for agents, revert specific hunks, and leave inline comments that agents can act on in real time.
+
 ## Overview
 
 When you are working locally in a Git repository with uncommitted changes, the **Code Review panel** lets you inspect, edit, and manage code changes directly inside Warp. It integrates with Git and Warp's Agents, giving you the ability to:

src/content/docs/code/overview.mdx

@@ -6,6 +6,8 @@ description: >-
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
+Warp's coding features help you go from prompt to production. They combine a dedicated coding agent — consistently ranked among the top on SWE-bench Verified — with a native code editor, inline diff review, codebase context, and project-level rules for accurate, context-aware code generation.
+
 :::note
 On macOS and Linux SSH sessions, Warp's [SSH extension](/terminal/warpify/ssh/#installing-the-ssh-extension) brings the file tree, native file reads, and native code diffs to remote hosts. See [Feature support over SSH](/code/ssh-feature-support/) for the current support matrix.
 :::

src/content/docs/getting-started/supported-shells.mdx

@@ -7,6 +7,8 @@ sidebar:
   label: "Supported shells"
 ---
 
+Warp supports bash, zsh, fish, and PowerShell (pwsh) across macOS, Windows, and Linux, loading your login shell by default. You can change the default shell per-session, customize each shell's configuration files and environment variables, and install additional shells like fish or PowerShell on macOS.
+
 ## Warp default shell
 
 Warp tries to load your login shell by default. Currently, Warp supports bash, fish, zsh, and PowerShell (pwsh). If your login shell is set to something else (e.g. Nushell) Warp will show a banner indicating it's not supported and load the default shells listed below: