From 153b71c186cd1fd9e6dfbbd3efda5bf87fd16af5 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Mon, 11 May 2026 11:56:16 -1000 Subject: [PATCH 1/5] Add AEO citation blocks (40-60 word summaries) to 15 key docs pages Add answer-first introductory paragraphs to Tier 1 docs pages to improve AI answer engine citability. Each citation block is a concise 40-60 word summary placed at the top of the page that directly answers 'What is this feature?' in a self-contained, extractable format. Pages updated: - Site root (index.mdx), quickstart, agents overview - Local agents, cloud agents, CLI agents overviews - Capabilities, MCP, Warp Drive, Blocks, Code, Editor overviews - Oz CLI and API/SDK references, Enterprise overview Co-Authored-By: Oz --- src/content/docs/agent-platform/capabilities/index.mdx | 4 +--- src/content/docs/agent-platform/cloud-agents/overview.mdx | 2 +- src/content/docs/agent-platform/index.mdx | 2 +- src/content/docs/agent-platform/local-agents/overview.mdx | 2 ++ src/content/docs/code/overview.mdx | 2 ++ src/content/docs/index.mdx | 2 +- .../docs/knowledge-and-collaboration/warp-drive/index.mdx | 2 ++ src/content/docs/quickstart.mdx | 2 +- src/content/docs/reference/api-and-sdk/index.mdx | 2 ++ src/content/docs/reference/cli/index.mdx | 2 ++ src/content/docs/terminal/blocks/index.mdx | 2 ++ src/content/docs/terminal/editor/index.mdx | 2 ++ 12 files changed, 19 insertions(+), 7 deletions(-) diff --git a/src/content/docs/agent-platform/capabilities/index.mdx b/src/content/docs/agent-platform/capabilities/index.mdx index 242e05b5..2395e4ee 100644 --- a/src/content/docs/agent-platform/capabilities/index.mdx +++ b/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 diff --git a/src/content/docs/agent-platform/cloud-agents/overview.mdx b/src/content/docs/agent-platform/cloud-agents/overview.mdx index 2aabbdcd..ec6a8823 100644 --- a/src/content/docs/agent-platform/cloud-agents/overview.mdx +++ b/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. diff --git a/src/content/docs/agent-platform/index.mdx b/src/content/docs/agent-platform/index.mdx index 77fd64b4..ee66a21e 100644 --- a/src/content/docs/agent-platform/index.mdx +++ b/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. diff --git a/src/content/docs/agent-platform/local-agents/overview.mdx b/src/content/docs/agent-platform/local-agents/overview.mdx index 725b3aa8..c1cf191f 100644 --- a/src/content/docs/agent-platform/local-agents/overview.mdx +++ b/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. diff --git a/src/content/docs/code/overview.mdx b/src/content/docs/code/overview.mdx index a5abd773..3e2b7787 100644 --- a/src/content/docs/code/overview.mdx +++ b/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. ::: diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index 8d329375..fd30c935 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -8,7 +8,7 @@ sidebar: --- import VideoEmbed from '@components/VideoEmbed.astro'; -Warp is an [open source](https://github.com/warpdotdev/warp) **Agentic Development Environment**, a modern terminal combined with powerful agents that help you build, test, deploy, and debug code. Warp's AI is powered by **Oz**, the orchestration platform for cloud agents. +Warp is an [open-source](https://github.com/warpdotdev/warp) **Agentic Development Environment** that combines a modern, high-performance terminal with powerful agents to help you build, test, deploy, and debug code. Warp's agents are powered by **Oz**, the orchestration platform for running agents locally or in the cloud at scale.
![Warp, the Agentic Development Environment: Warp (a modern terminal built for coding with agents) and Oz (the orchestration platform for cloud agents)](../../assets/terminal/warp-oz-welcome.png) diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx index 8ac2546a..7759d603 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx @@ -8,6 +8,8 @@ description: >- import { Tabs, TabItem } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; +Warp Drive is a built-in workspace for saving and sharing Workflows, Notebooks, Prompts, and Environment Variables across your team. All objects sync in real time, so you and your team always have access to the latest versions — whether you're working locally or collaborating across an organization. + ## What is Warp Drive? All objects stored in Warp Drive sync immediately as they’re updated, so you and your team will always have access to the latest versions. diff --git a/src/content/docs/quickstart.mdx b/src/content/docs/quickstart.mdx index 04f6ae8e..bdcf9ea3 100644 --- a/src/content/docs/quickstart.mdx +++ b/src/content/docs/quickstart.mdx @@ -6,7 +6,7 @@ description: >- --- import { Tabs, TabItem } from '@astrojs/starlight/components'; -This guide walks you through installing Warp, trying the terminal features you'll use every day, and firing off your first agent prompt. After completing the steps in this guide, you'll have a working Warp setup and a clear picture of how terminal commands and agents work together. +Get up and running with Warp in about 10 minutes. Install the app, run your first commands using Blocks and the modern text editor, and start an agent conversation to write code, debug issues, or explore your codebase — all from natural language prompts inside the terminal. --- diff --git a/src/content/docs/reference/api-and-sdk/index.mdx b/src/content/docs/reference/api-and-sdk/index.mdx index 9683881c..492bece0 100644 --- a/src/content/docs/reference/api-and-sdk/index.mdx +++ b/src/content/docs/reference/api-and-sdk/index.mdx @@ -8,6 +8,8 @@ description: >- --- import VideoEmbed from '@components/VideoEmbed.astro'; +The Oz API and SDKs let you create, monitor, and inspect cloud agent runs programmatically. Use the REST API from any HTTP client, or the official Python and TypeScript SDKs for typed requests, built-in retries, and structured error handling — ideal for CI pipelines, internal tools, and custom integrations. + ### Oz API The Oz API lets you create and inspect [Cloud Agent](/agent-platform/cloud-agents/overview/) runs over HTTP from any system (CI, cron, backend services, internal tools), without requiring the Warp desktop app. diff --git a/src/content/docs/reference/cli/index.mdx b/src/content/docs/reference/cli/index.mdx index f37ef770..bc84320d 100644 --- a/src/content/docs/reference/cli/index.mdx +++ b/src/content/docs/reference/cli/index.mdx @@ -7,6 +7,8 @@ description: >- --- import { Tabs, TabItem } from '@astrojs/starlight/components'; +The Oz CLI is the command-line tool for running and managing Warp's cloud agents from any terminal, script, or CI pipeline. Use it to start agents locally or in the cloud, connect MCP servers, configure integrations, and authenticate — all without requiring the Warp desktop app. + :::note **`warp-cli` is deprecated and has been replaced by `oz`.** If you have `warp-cli` installed, it will auto-update to `oz`. All the same commands are available, just replace `warp-cli` with `oz` in your scripts and workflows. ::: diff --git a/src/content/docs/terminal/blocks/index.mdx b/src/content/docs/terminal/blocks/index.mdx index 501e8cdf..f339991f 100644 --- a/src/content/docs/terminal/blocks/index.mdx +++ b/src/content/docs/terminal/blocks/index.mdx @@ -5,6 +5,8 @@ description: >- --- import VideoEmbed from '@components/VideoEmbed.astro'; +Blocks are Warp's fundamental unit for organizing terminal output. Every command and its output is grouped into a single Block that you can copy, search, filter, bookmark, share, and navigate independently — replacing the endless scroll of traditional terminals with structured, actionable output. + ## What are Blocks? Blocks enable us to easily: diff --git a/src/content/docs/terminal/editor/index.mdx b/src/content/docs/terminal/editor/index.mdx index 9649b964..07d7dd78 100644 --- a/src/content/docs/terminal/editor/index.mdx +++ b/src/content/docs/terminal/editor/index.mdx @@ -7,6 +7,8 @@ description: >- import { Tabs, TabItem } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; +Warp's input editor works like a modern IDE text editor, with cursor movement, click-to-place, multi-line editing, copy-paste, word selection, and soft wrapping built in. Unlike traditional terminals, you can edit commands the same way you edit code — no memorizing shell-specific shortcuts required. + :::note Text Editor Input also works for [SSH sessions](/terminal/warpify/ssh/). ::: From 9695f16396c5a58a13b10e6b7f03c84d397daa0d Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Tue, 12 May 2026 07:09:13 -1000 Subject: [PATCH 2/5] Reduce em dash usage in citation blocks by ~50% Replace 5 of 9 em dashes with commas, periods, or rewording. Keep em dashes only where they serve as strong contrast or parenthetical asides (cloud agents, code, blocks, editor). Co-Authored-By: Oz --- src/content/docs/agent-platform/capabilities/index.mdx | 2 +- .../docs/knowledge-and-collaboration/warp-drive/index.mdx | 2 +- src/content/docs/quickstart.mdx | 2 +- src/content/docs/reference/api-and-sdk/index.mdx | 2 +- src/content/docs/reference/cli/index.mdx | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/src/content/docs/agent-platform/capabilities/index.mdx b/src/content/docs/agent-platform/capabilities/index.mdx index 2395e4ee..76c6459d 100644 --- a/src/content/docs/agent-platform/capabilities/index.mdx +++ b/src/content/docs/agent-platform/capabilities/index.mdx @@ -5,7 +5,7 @@ description: >- what context they have access to, and how they execute tasks. --- -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. +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 diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx index 7759d603..690c3bc9 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/index.mdx @@ -8,7 +8,7 @@ description: >- import { Tabs, TabItem } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; -Warp Drive is a built-in workspace for saving and sharing Workflows, Notebooks, Prompts, and Environment Variables across your team. All objects sync in real time, so you and your team always have access to the latest versions — whether you're working locally or collaborating across an organization. +Warp Drive is a built-in workspace for saving and sharing Workflows, Notebooks, Prompts, and Environment Variables across your team. All objects sync in real time, so you and your team always have access to the latest versions, whether you're working locally or collaborating across an organization. ## What is Warp Drive? diff --git a/src/content/docs/quickstart.mdx b/src/content/docs/quickstart.mdx index bdcf9ea3..c23cbb73 100644 --- a/src/content/docs/quickstart.mdx +++ b/src/content/docs/quickstart.mdx @@ -6,7 +6,7 @@ description: >- --- import { Tabs, TabItem } from '@astrojs/starlight/components'; -Get up and running with Warp in about 10 minutes. Install the app, run your first commands using Blocks and the modern text editor, and start an agent conversation to write code, debug issues, or explore your codebase — all from natural language prompts inside the terminal. +Get up and running with Warp in about 10 minutes. Install the app, run your first commands using Blocks and the modern text editor, and start an agent conversation to write code, debug issues, or explore your codebase, all from natural language prompts inside the terminal. --- diff --git a/src/content/docs/reference/api-and-sdk/index.mdx b/src/content/docs/reference/api-and-sdk/index.mdx index 492bece0..152d8643 100644 --- a/src/content/docs/reference/api-and-sdk/index.mdx +++ b/src/content/docs/reference/api-and-sdk/index.mdx @@ -8,7 +8,7 @@ description: >- --- import VideoEmbed from '@components/VideoEmbed.astro'; -The Oz API and SDKs let you create, monitor, and inspect cloud agent runs programmatically. Use the REST API from any HTTP client, or the official Python and TypeScript SDKs for typed requests, built-in retries, and structured error handling — ideal for CI pipelines, internal tools, and custom integrations. +The Oz API and SDKs let you create, monitor, and inspect cloud agent runs programmatically. Use the REST API from any HTTP client, or the official Python and TypeScript SDKs for typed requests, built-in retries, and structured error handling. The SDKs are ideal for CI pipelines, internal tools, and custom integrations. ### Oz API diff --git a/src/content/docs/reference/cli/index.mdx b/src/content/docs/reference/cli/index.mdx index bc84320d..a2d6fd30 100644 --- a/src/content/docs/reference/cli/index.mdx +++ b/src/content/docs/reference/cli/index.mdx @@ -7,7 +7,7 @@ description: >- --- import { Tabs, TabItem } from '@astrojs/starlight/components'; -The Oz CLI is the command-line tool for running and managing Warp's cloud agents from any terminal, script, or CI pipeline. Use it to start agents locally or in the cloud, connect MCP servers, configure integrations, and authenticate — all without requiring the Warp desktop app. +The Oz CLI is the command-line tool for running and managing Warp's cloud agents from any terminal, script, or CI pipeline. Use it to start agents locally or in the cloud, connect MCP servers, configure integrations, and authenticate without requiring the Warp desktop app. :::note **`warp-cli` is deprecated and has been replaced by `oz`.** If you have `warp-cli` installed, it will auto-update to `oz`. All the same commands are available, just replace `warp-cli` with `oz` in your scripts and workflows. From fc61e6af26e45cb8e5d7955febfeebca0e84849e Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Tue, 12 May 2026 11:10:03 -0600 Subject: [PATCH 3/5] Apply suggestion from @oz-for-oss[bot] Co-authored-by: oz-for-oss[bot] <277970191+oz-for-oss[bot]@users.noreply.github.com> --- src/content/docs/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx index fd30c935..9e489ea2 100644 --- a/src/content/docs/index.mdx +++ b/src/content/docs/index.mdx @@ -8,7 +8,7 @@ sidebar: --- import VideoEmbed from '@components/VideoEmbed.astro'; -Warp is an [open-source](https://github.com/warpdotdev/warp) **Agentic Development Environment** that combines a modern, high-performance terminal with powerful agents to help you build, test, deploy, and debug code. Warp's agents are powered by **Oz**, the orchestration platform for running agents locally or in the cloud at scale. +Warp is an [open source](https://github.com/warpdotdev/warp) **Agentic Development Environment** that combines a modern, high-performance terminal with powerful agents to help you build, test, deploy, and debug code. Warp's agents are powered by **Oz**, the orchestration platform for running agents locally or in the cloud at scale.
![Warp, the Agentic Development Environment: Warp (a modern terminal built for coding with agents) and Oz (the orchestration platform for cloud agents)](../../assets/terminal/warp-oz-welcome.png) From 7f55ba678bcda4e092df65508ee8e5d2c4f7d9c1 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Tue, 12 May 2026 07:13:56 -1000 Subject: [PATCH 4/5] Add Phase 2 citation blocks and fix 'open source' hyphen Add 40-60 word answer-first citation blocks to 9 more pages: - Model choice, Agent Profiles, Teams, Admin Panel - Code Review, Command Palette, Sessions, Supported Shells - Plans and billing Also fix 'open-source' -> 'open source' on index.mdx per style guide. 9 Phase 2 pages already had good intros and were left unchanged: Skills, Rules, Codebase Context, Environments, Secrets, Integrations, Planning, Code Editor, Managing Cloud Agents. Co-Authored-By: Oz --- .../agent-platform/capabilities/agent-profiles-permissions.mdx | 2 ++ src/content/docs/agent-platform/capabilities/model-choice.mdx | 2 ++ src/content/docs/code/code-review.mdx | 2 ++ src/content/docs/getting-started/supported-shells.mdx | 2 ++ src/content/docs/knowledge-and-collaboration/admin-panel.mdx | 2 ++ src/content/docs/knowledge-and-collaboration/teams.mdx | 2 ++ .../docs/support-and-community/plans-and-billing/index.mdx | 2 +- src/content/docs/terminal/command-palette.mdx | 2 ++ src/content/docs/terminal/sessions/index.mdx | 2 ++ 9 files changed, 17 insertions(+), 1 deletion(-) diff --git a/src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx b/src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx index c93c436f..d7da4531 100644 --- a/src/content/docs/agent-platform/capabilities/agent-profiles-permissions.mdx +++ b/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**. diff --git a/src/content/docs/agent-platform/capabilities/model-choice.mdx b/src/content/docs/agent-platform/capabilities/model-choice.mdx index 95e14e6c..3fd2615d 100644 --- a/src/content/docs/agent-platform/capabilities/model-choice.mdx +++ b/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. diff --git a/src/content/docs/code/code-review.mdx b/src/content/docs/code/code-review.mdx index f532917d..f411412e 100644 --- a/src/content/docs/code/code-review.mdx +++ b/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: diff --git a/src/content/docs/getting-started/supported-shells.mdx b/src/content/docs/getting-started/supported-shells.mdx index 7b0d9ed1..45ba8e84 100644 --- a/src/content/docs/getting-started/supported-shells.mdx +++ b/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: diff --git a/src/content/docs/knowledge-and-collaboration/admin-panel.mdx b/src/content/docs/knowledge-and-collaboration/admin-panel.mdx index 8c23a899..1c69a162 100644 --- a/src/content/docs/knowledge-and-collaboration/admin-panel.mdx +++ b/src/content/docs/knowledge-and-collaboration/admin-panel.mdx @@ -5,6 +5,8 @@ description: >- settings enforced across all team members. --- +The Admin Panel gives team administrators centralized control over organization-wide Warp settings, including agent autonomy, privacy controls, billing limits, codebase indexing, and sharing policies. Settings configured in the Admin Panel are enforced across all team members and override individual preferences. + ## What is the Admin Panel? The [Admin Panel](https://app.warp.dev/admin/) provides team administrators with centralized control over organization-wide settings in Warp. It allows you to manage workspace settings that are enforced across all members of your team. diff --git a/src/content/docs/knowledge-and-collaboration/teams.mdx b/src/content/docs/knowledge-and-collaboration/teams.mdx index 3602f8e9..7c3f8f76 100644 --- a/src/content/docs/knowledge-and-collaboration/teams.mdx +++ b/src/content/docs/knowledge-and-collaboration/teams.mdx @@ -5,6 +5,8 @@ description: >- --- import VideoEmbed from '@components/VideoEmbed.astro'; +A Warp team is a group of users who collaborate through a shared workspace in Warp Drive. Teams share Workflows, Notebooks, Prompts, Rules, and Environment Variables, with role-based permissions for admins and members. Each Warp user can belong to one team at a time. + ## What is a team? A team is a group of Warp users who can collaborate on the command line together. Warp teams can share a dedicated workspace in Warp Drive. [Learn about pricing](https://www.warp.dev/pricing) and see our [Pricing FAQ](/support-and-community/plans-and-billing/pricing-faqs/). diff --git a/src/content/docs/support-and-community/plans-and-billing/index.mdx b/src/content/docs/support-and-community/plans-and-billing/index.mdx index ae1490f1..692b4fc9 100644 --- a/src/content/docs/support-and-community/plans-and-billing/index.mdx +++ b/src/content/docs/support-and-community/plans-and-billing/index.mdx @@ -5,7 +5,7 @@ description: >- billing settings. --- -Warp offers flexible plans designed for individual developers, teams, and enterprises. Learn about pricing, credits, and billing options. +Warp offers flexible plans for individual developers, teams, and enterprises, with credits powering all agent features. Choose from plan-included credits, add-on credit purchases, automatic reloads, or bring-your-own API keys. Compare plans, manage billing, and track credit usage from your account settings. * [**Plans & Pricing**](/support-and-community/plans-and-billing/plans-pricing-refunds/) - Compare plans, pricing tiers, and refund policies * [**Credits**](/support-and-community/plans-and-billing/credits/) - How credits are used and calculated across AI features diff --git a/src/content/docs/terminal/command-palette.mdx b/src/content/docs/terminal/command-palette.mdx index 0dbfd508..7dc3999d 100644 --- a/src/content/docs/terminal/command-palette.mdx +++ b/src/content/docs/terminal/command-palette.mdx @@ -7,6 +7,8 @@ description: >- import { Tabs, TabItem } from '@astrojs/starlight/components'; import VideoEmbed from '@components/VideoEmbed.astro'; +The Command Palette is Warp's global search interface for quickly finding and launching Workflows, Notebooks, Prompts, keyboard shortcuts, file searches, settings, and other actions. Open it with a keyboard shortcut, then type or filter results by type to find exactly what you need. +
![Command Palette Panel](../../../assets/terminal/command-palette-panel.png)
Command Palette Panel.
diff --git a/src/content/docs/terminal/sessions/index.mdx b/src/content/docs/terminal/sessions/index.mdx index 746c27b9..0a66f04a 100644 --- a/src/content/docs/terminal/sessions/index.mdx +++ b/src/content/docs/terminal/sessions/index.mdx @@ -7,6 +7,8 @@ description: >- import DemoVideo from '@components/DemoVideo.astro'; import VideoEmbed from '@components/VideoEmbed.astro'; +Warp sessions let you navigate between terminal sessions and automatically restore your workspace when you relaunch the app. Session Navigation helps you quickly switch between active sessions, while Session Restoration preserves your windows, tabs, and panes across restarts. + 1. [Session Navigation](/terminal/sessions/session-navigation/) enables you to easily navigate to any session in Warp. 2. [Session Restoration](/terminal/sessions/session-restoration/) automatically restores the window and tabs from your previous session. From 83c7068a2ff0fa7bdbdfb8dd24fb09ced8d8bb34 Mon Sep 17 00:00:00 2001 From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com> Date: Tue, 12 May 2026 07:47:28 -1000 Subject: [PATCH 5/5] Add Phase 3 citation blocks to 32 high-value pages Add 40-60 word answer-first citation blocks to remaining high-value pages: - Capabilities: Full Terminal Use, Slash Commands, Task Lists - Cloud agents: Slack integration, cloud providers, demo issue triage - Local agents: Active AI, code diffs, interactive code review, interacting with agents, terminal/agent modes, generate, voice, and all 5 agent-context sub-pages (blocks, images, selections, URLs, @ context) - Code: Vim keybindings, file tree, find and replace - Warp Drive: Workflows, Notebooks, Prompts, Environment Variables, Agent Mode Context, Warp on the Web - Reference: CLI agent profiles, troubleshooting, Warp Drive context, reference index - Getting started: Agents in Warp, Agent FAQs 42 pages already had good intros and were left unchanged. 10 deep procedural pages (self-hosting) were skipped. Co-Authored-By: Oz --- .../docs/agent-platform/capabilities/full-terminal-use.mdx | 2 +- .../docs/agent-platform/capabilities/slash-commands.mdx | 2 +- src/content/docs/agent-platform/capabilities/task-lists.mdx | 4 +--- .../cloud-agents/integrations/cloud-providers.mdx | 6 +----- .../cloud-agents/integrations/demo-issue-triage-bot.mdx | 2 ++ .../docs/agent-platform/cloud-agents/integrations/slack.mdx | 2 ++ .../docs/agent-platform/getting-started/agents-in-warp.mdx | 2 ++ src/content/docs/agent-platform/getting-started/faqs.mdx | 2 ++ src/content/docs/agent-platform/local-agents/active-ai.mdx | 2 ++ .../local-agents/agent-context/blocks-as-context.mdx | 2 ++ .../local-agents/agent-context/images-as-context.mdx | 2 ++ .../local-agents/agent-context/selection-as-context.mdx | 2 ++ .../local-agents/agent-context/urls-as-context.mdx | 2 ++ .../local-agents/agent-context/using-to-add-context.mdx | 2 ++ src/content/docs/agent-platform/local-agents/code-diffs.mdx | 2 ++ src/content/docs/agent-platform/local-agents/generate.mdx | 2 ++ .../local-agents/interacting-with-agents/index.mdx | 2 ++ .../interacting-with-agents/terminal-and-agent-modes.mdx | 2 +- .../agent-platform/local-agents/interactive-code-review.mdx | 2 ++ .../docs/code/code-editor/code-editor-vim-keybindings.mdx | 2 ++ src/content/docs/code/code-editor/file-tree.mdx | 2 ++ src/content/docs/code/code-editor/find-and-replace.mdx | 2 ++ .../warp-drive/agent-mode-context.mdx | 2 +- .../warp-drive/environment-variables.mdx | 2 ++ .../knowledge-and-collaboration/warp-drive/notebooks.mdx | 2 ++ .../docs/knowledge-and-collaboration/warp-drive/prompts.mdx | 2 ++ .../docs/knowledge-and-collaboration/warp-drive/web.mdx | 2 ++ .../knowledge-and-collaboration/warp-drive/workflows.mdx | 2 ++ src/content/docs/reference/cli/agent-profiles.mdx | 2 ++ src/content/docs/reference/cli/troubleshooting.mdx | 2 ++ src/content/docs/reference/cli/warp-drive.mdx | 2 ++ src/content/docs/reference/index.mdx | 2 +- 32 files changed, 57 insertions(+), 13 deletions(-) diff --git a/src/content/docs/agent-platform/capabilities/full-terminal-use.mdx b/src/content/docs/agent-platform/capabilities/full-terminal-use.mdx index cd2f8659..3d655e7f 100644 --- a/src/content/docs/agent-platform/capabilities/full-terminal-use.mdx +++ b/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. diff --git a/src/content/docs/agent-platform/capabilities/slash-commands.mdx b/src/content/docs/agent-platform/capabilities/slash-commands.mdx index e3a2d51d..3f0920c4 100644 --- a/src/content/docs/agent-platform/capabilities/slash-commands.mdx +++ b/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.
![Slash Commands menu](../../../../assets/agent-platform/slash-commands-menu.png) diff --git a/src/content/docs/agent-platform/capabilities/task-lists.mdx b/src/content/docs/agent-platform/capabilities/task-lists.mdx index 06c69128..effdbfb4 100644 --- a/src/content/docs/agent-platform/capabilities/task-lists.mdx +++ b/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.
![An example of a task list in progress.](../../../../assets/agent-platform/in-progress-tasklist.png) 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 112fc8ea..4036cddc 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 @@ -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. --- 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 53d009b1..1fa8e695 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 @@ -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. + :::note diff --git a/src/content/docs/agent-platform/cloud-agents/integrations/slack.mdx b/src/content/docs/agent-platform/cloud-agents/integrations/slack.mdx index 4eb76219..44d19b0d 100644 --- a/src/content/docs/agent-platform/cloud-agents/integrations/slack.mdx +++ b/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. diff --git a/src/content/docs/agent-platform/getting-started/agents-in-warp.mdx b/src/content/docs/agent-platform/getting-started/agents-in-warp.mdx index 71a870a9..43b33c0c 100644 --- a/src/content/docs/agent-platform/getting-started/agents-in-warp.mdx +++ b/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. + 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. diff --git a/src/content/docs/agent-platform/getting-started/faqs.mdx b/src/content/docs/agent-platform/getting-started/faqs.mdx index 5c237f00..a400fed2 100644 --- a/src/content/docs/agent-platform/getting-started/faqs.mdx +++ b/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? diff --git a/src/content/docs/agent-platform/local-agents/active-ai.mdx b/src/content/docs/agent-platform/local-agents/active-ai.mdx index 63f82f24..5bb6f8be 100644 --- a/src/content/docs/agent-platform/local-agents/active-ai.mdx +++ b/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. ::: diff --git a/src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx b/src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx index fbe910c3..75e40d8e 100644 --- a/src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx +++ b/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. diff --git a/src/content/docs/agent-platform/local-agents/agent-context/images-as-context.mdx b/src/content/docs/agent-platform/local-agents/agent-context/images-as-context.mdx index 50e775fc..6e7adfde 100644 --- a/src/content/docs/agent-platform/local-agents/agent-context/images-as-context.mdx +++ b/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. diff --git a/src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx b/src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx index 91c7cbff..bb2f82ba 100644 --- a/src/content/docs/agent-platform/local-agents/agent-context/selection-as-context.mdx +++ b/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: diff --git a/src/content/docs/agent-platform/local-agents/agent-context/urls-as-context.mdx b/src/content/docs/agent-platform/local-agents/agent-context/urls-as-context.mdx index c416ed2d..25ae2fef 100644 --- a/src/content/docs/agent-platform/local-agents/agent-context/urls-as-context.mdx +++ b/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. diff --git a/src/content/docs/agent-platform/local-agents/agent-context/using-to-add-context.mdx b/src/content/docs/agent-platform/local-agents/agent-context/using-to-add-context.mdx index c2b67403..32777665 100644 --- a/src/content/docs/agent-platform/local-agents/agent-context/using-to-add-context.mdx +++ b/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. diff --git a/src/content/docs/agent-platform/local-agents/code-diffs.mdx b/src/content/docs/agent-platform/local-agents/code-diffs.mdx index c2ca0fb3..e8abece9 100644 --- a/src/content/docs/agent-platform/local-agents/code-diffs.mdx +++ b/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. diff --git a/src/content/docs/agent-platform/local-agents/generate.mdx b/src/content/docs/agent-platform/local-agents/generate.mdx index 55cf5000..93be673f 100644 --- a/src/content/docs/agent-platform/local-agents/generate.mdx +++ b/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. diff --git a/src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx b/src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx index 9aa4a052..6438f547 100644 --- a/src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx +++ b/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. diff --git a/src/content/docs/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx b/src/content/docs/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx index 6b07099d..fa693766 100644 --- a/src/content/docs/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx +++ b/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. diff --git a/src/content/docs/agent-platform/local-agents/interactive-code-review.mdx b/src/content/docs/agent-platform/local-agents/interactive-code-review.mdx index b568d9f7..05837456 100644 --- a/src/content/docs/agent-platform/local-agents/interactive-code-review.mdx +++ b/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. 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 cd5c6379..75226cf1 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 @@ -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. diff --git a/src/content/docs/code/code-editor/file-tree.mdx b/src/content/docs/code/code-editor/file-tree.mdx index a6ab1345..2a870704 100644 --- a/src/content/docs/code/code-editor/file-tree.mdx +++ b/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. 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 073695fb..5b52870c 100644 --- a/src/content/docs/code/code-editor/find-and-replace.mdx +++ b/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. 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 79e885f9..247cc7f3 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 @@ -7,7 +7,7 @@ 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. +Warp's agents automatically pull context from your Warp Drive contents, including Workflows, Notebooks, Environment Variables, Rules, and MCP Servers, to generate responses tailored to your personal and team developer workflows. Referenced objects appear as citations in the conversation. ## Objects used as context diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.mdx index c4f893e9..fcfdcf98 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/environment-variables.mdx @@ -4,6 +4,8 @@ description: >- Save or sync environment variables to load into your terminal sessions. --- +Environment Variables in Warp Drive let you save, sync, and load environment variables into your terminal sessions with a click. Support for both static values and dynamic secrets from external managers like 1Password, LastPass, and Hashicorp Vault keeps credentials secure and out of source code. + ## What are environment variables in Warp? Environment variables in Warp are similar to .env files, except you can: 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 8259d964..cd1428b9 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/notebooks.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/notebooks.mdx @@ -7,6 +7,8 @@ sidebar: --- import { Tabs, TabItem } from '@astrojs/starlight/components'; +Notebooks are interactive, runnable documents in Warp Drive that combine markdown text with executable shell command blocks. Use them for onboarding playbooks, debugging runbooks, and development workflows that teammates can search, share, and execute directly from the terminal. + ### What is a Notebook? Notebooks are runnable documentation consisting of markdown text and list elements, code blocks, and runnable shell snippets that can be automatically executed in your terminal session. Notebooks are searchable and accessible through the [Command Palette](/terminal/command-palette/) so you can access and run your documentation without ever leaving the terminal. You can also export Notebooks in .md format at any time. 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 59119a24..b4fd44d4 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/prompts.mdx @@ -7,6 +7,8 @@ sidebar: --- import VideoEmbed from '@components/VideoEmbed.astro'; +Prompts are parameterized natural language queries you can save in Warp Drive and reuse with agents. Name a prompt, add arguments for dynamic values, and execute it from the Command Palette or Warp Drive to repeat complex agent workflows without retyping. + ## What is a prompt? A prompt is a parameterized natural language query you can name and save in Warp to use with [Agent Mode](/agent-platform/local-agents/interacting-with-agents/). diff --git a/src/content/docs/knowledge-and-collaboration/warp-drive/web.mdx b/src/content/docs/knowledge-and-collaboration/warp-drive/web.mdx index 420a2892..be8f38b7 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/web.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/web.mdx @@ -5,6 +5,8 @@ description: >- screen device, including mobile phones, tablets, and touch-enabled laptops. --- +Warp Drive on the Web lets you view and edit Warp Drive objects and shared sessions directly in any browser, including mobile devices and tablets. Access Workflows, Notebooks, Prompts, and session transcripts from anywhere without installing the Warp desktop app. + ## What is Warp on the web? Warp Drive on the Web lets you view and edit your Warp Drive objects and shared sessions directly in the browser, on any device. 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 132be529..307d1a40 100644 --- a/src/content/docs/knowledge-and-collaboration/warp-drive/workflows.mdx +++ b/src/content/docs/knowledge-and-collaboration/warp-drive/workflows.mdx @@ -9,6 +9,8 @@ sidebar: import DemoVideo from '@components/DemoVideo.astro'; import VideoEmbed from '@components/VideoEmbed.astro'; +Workflows are parameterized commands you can name, save, and share in Warp Drive. Define arguments with default values, add descriptions for search, and execute workflows from the Command Palette or Warp Drive to run frequently used commands without retyping them. + ## What is a workflow? A workflow is a parameterized command you can name and save in Warp with descriptions and arguments. Workflows are searchable and easily accessed from the [Command Palette](/terminal/command-palette/) so you can find and execute them without switching contexts. diff --git a/src/content/docs/reference/cli/agent-profiles.mdx b/src/content/docs/reference/cli/agent-profiles.mdx index 575f3e45..91dc9787 100644 --- a/src/content/docs/reference/cli/agent-profiles.mdx +++ b/src/content/docs/reference/cli/agent-profiles.mdx @@ -7,6 +7,8 @@ sidebar: label: "Agent Profiles" --- +Agent profiles control what the agent can do, how it behaves, and where it can act when running from the Oz CLI. Create profiles in the Warp app to configure file access, command execution, MCP server usage, model selection, and directory permissions, then reference them by ID in CLI commands. + Agent profiles control three things: * **What the agent can do** — file access, command execution, and MCP server usage diff --git a/src/content/docs/reference/cli/troubleshooting.mdx b/src/content/docs/reference/cli/troubleshooting.mdx index 81658beb..025b9d80 100644 --- a/src/content/docs/reference/cli/troubleshooting.mdx +++ b/src/content/docs/reference/cli/troubleshooting.mdx @@ -5,6 +5,8 @@ description: >- failures, environments, GitHub access, and Docker image issues. --- +Solutions for common Oz CLI errors, including authentication issues, agent failures, environment configuration, GitHub access problems, and Docker image compatibility. Use `oz help` for built-in documentation on any command. + ## Getting help The CLI includes built-in documentation for all commands: diff --git a/src/content/docs/reference/cli/warp-drive.mdx b/src/content/docs/reference/cli/warp-drive.mdx index 3311a9eb..3cda4c1c 100644 --- a/src/content/docs/reference/cli/warp-drive.mdx +++ b/src/content/docs/reference/cli/warp-drive.mdx @@ -7,6 +7,8 @@ sidebar: label: "Warp Drive Context" --- +Reference saved Warp Drive objects in Oz CLI commands to reuse prompts, notebooks, workflows, and rules as agent context. Pass a saved prompt ID with `--saved-prompt` or inline Warp Drive references using ``, ``, or `` syntax. + ## Reusing saved prompts When you find prompts that work well, save them in [Warp Drive](/knowledge-and-collaboration/warp-drive/) to reuse across sessions, share with teammates, and integrate into automated workflows. For more information, see [Prompts](/knowledge-and-collaboration/warp-drive/prompts/). diff --git a/src/content/docs/reference/index.mdx b/src/content/docs/reference/index.mdx index 0747cdc4..4acfd0f2 100644 --- a/src/content/docs/reference/index.mdx +++ b/src/content/docs/reference/index.mdx @@ -4,7 +4,7 @@ description: >- Technical reference documentation for the Oz CLI, API, and SDK. --- -This section covers the programmatic interfaces for running and managing agents in CI pipelines, scripts, backend services, and custom tooling. +Technical reference documentation for the Oz CLI, API, and SDKs. Use these programmatic interfaces to run and manage agents from CI pipelines, scripts, backend services, and custom tooling without requiring the Warp desktop app. ## CLI