docs: deep polish across all sections (typos, terminology, formatting)

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

@@ -52,7 +52,7 @@ The mailbox includes:
 
 * `↑` / `↓` - select previous / next notification
 * `Enter` - open the selected notification's session
-* `Shift-Tab` - cycle through filter tabs
+* `Shift+Tab` - cycle through filter tabs
 * `Esc` - close the mailbox
 
 ### Tab status indicators
@@ -114,7 +114,7 @@ That means:
 * [Desktop Notifications](/terminal/more-features/notifications/) - configure system-level notification permissions and troubleshoot delivery
 * [Managing Agents](/agent-platform/cloud-agents/managing-cloud-agents/) - monitor all agent conversations, filter by status, and inspect sessions
 * [Multi-agent orchestration](/agent-platform/cloud-agents/orchestration/) - parent/child model, run state transitions, and the orchestration pill bar
-* [Third-Party CLI Agents](/agent-platform/cli-agents/overview/) - overview of supported CLI agents and Warp features
+* [Third-party CLI agents](/agent-platform/cli-agents/overview/) - overview of supported CLI agents and Warp features
 * [Claude Code](/agent-platform/cli-agents/claude-code/) - setup and notification plugin installation
 * [Codex](/agent-platform/cli-agents/codex/) - setup and notification configuration
 * [OpenCode](/agent-platform/cli-agents/opencode/) - setup and notification plugin installation

src/content/docs/agent-platform/capabilities/codebase-context.mdx

@@ -32,7 +32,7 @@ git clone https://github.com/vercel/next.js.git && cd next.js
 
 ## Indexing your codebase
 
-When you open a directory in Warp, we check if it is part of a Git repository. If it is, Warp begins indexing the source code to provide rich context for Agents. Warp also detects [Git worktree](/code/git-worktrees/) checkouts — each worktree is indexed as its own repository, so Agents always have accurate context for the branch you're working on. 
+When you open a directory in Warp, we check if it is part of a Git repository. If it is, Warp begins indexing the source code to provide rich context for Agents. Warp also detects [Git worktree](/code/git-worktrees/) checkouts — each worktree is indexed as its own repository, so Agents always have accurate context for the branch you're working on.
 
 :::note
 Code indexed with Codebase Context is never stored on our servers. Codebase Context works with both local agent sessions and [cloud agent runs](/agent-platform/cloud-agents/overview/). Without Codebase Context enabled, agents will still be able use terminal commands (i.e. `grep`, `sed`) to navigate your code.
@@ -73,7 +73,7 @@ You can view and manage your indexed codebases in **Settings** > **Code** > **In
 
 <VideoEmbed url="https://youtu.be/11rz9OYQ8Hg" title="Codebase Context indexing settings demo" />
 
-### **Codebase indexing states**
+### Codebase indexing states
 
 When viewing indexed codebases in Warp under **Settings** > **Code** > **Indexing and projects**, you may see different status indicators:
 
@@ -127,7 +127,7 @@ Codebase Context is available in all cloud agent runs — including runs trigger
 
 ## Multi-repo context
 
-Warp supports referencing context across multiple indexed repositories. Note that you don’t need to be inside a specific repo for agents to use its context.&#x20;
+Warp supports referencing context across multiple indexed repositories. Note that you don’t need to be inside a specific repo for agents to use its context.
 
 **This is especially useful when:**
 

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

@@ -31,7 +31,7 @@ You can either ask the agent to run an interactive command, or start one manuall
     * “Start the dev server and debug this 500 error.”
 * **Or start the command yourself, then tag the agent in**
   * Example:
-    * If you’ve already launched an interactive tool (for example `psql` or `npm run dev`), you can bring the agent into the running session using the "Use Agent" button in the terminal footer or via `CMD + I` .
+    * If you’ve already launched an interactive tool (for example `psql` or `npm run dev`), you can bring the agent into the running session using the **Use Agent** button in the terminal footer or via `Cmd+I`.
 
     <figure>
     ![Option to tag the agent into a running command.](../../../../assets/agent-platform/full-terminal-use-tag-hint.png)

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

@@ -7,7 +7,7 @@ description: >-
 import { Tabs, TabItem } from '@astrojs/starlight/components';
 import DemoVideo from '@components/DemoVideo.astro';
 
-MCP servers extend Warp's [local agents](/agent-platform/local-agents/interacting-with-agents/) in a modular, flexible way by exposing custom tools or data sources through a standardized interface — essentially acting as plugins for Warp. Warp supports a variety of connection protocols, including Streamable HTTPS and SSE, along with custom headers and environment variables.
+MCP servers extend Warp's [local agents](/agent-platform/local-agents/interacting-with-agents/) in a modular, flexible way by exposing custom tools or data sources through a standardized interface — essentially acting as plugins for Warp. Warp supports a variety of connection protocols, including Streamable HTTP and SSE, along with custom headers and environment variables.
 
 MCP is an open source protocol. Check out the official [MCP documentation](https://modelcontextprotocol.io/introduction) for more detailed information on how this protocol is engineered.
 
@@ -33,7 +33,7 @@ This will show a list of all configured MCP servers, including which are current
 
 ### Adding an MCP Server
 
-To add a new MCP server, you can click the **+ Add** button. Configurations from most MCP Clients can be directly copied and pasted.
+To add a new MCP server, you can click the **+ Add** button. Configurations from most MCP clients can be directly copied and pasted.
 
 MCP server types you can add:
 
@@ -78,9 +78,9 @@ MCP server types you can add:
 
 ### Adding multiple MCP servers
 
-Warp supports configuring **multiple MCP servers** using a JSON snippet. Each entry under `mcpServers` is keyed by a unique name (`filesystem`, `github`, `notes`, etc). All servers defined in the example are added automatically — no manual setup required.
+Warp supports configuring **multiple MCP servers** using a JSON snippet. Each entry under `mcpServers` is keyed by a unique name (`filesystem`, `github`, `notes`, etc.). All servers defined in the example are added automatically — no manual setup required.
 
-To add a multiple MCP servers, you can click the **+ Add** button then paste in a JSON snippet like the example below:
+To add multiple MCP servers, you can click the **+ Add** button then paste in a JSON snippet like the example below:
 
 ```json
 {
@@ -167,15 +167,15 @@ File-based servers that require OAuth show an authentication modal on their firs
 
 After MCP servers are registered in Warp, you can **Start** or **Stop** them from the MCP servers page. Each running server will have a list of available tools and resources.
 
-You can rename and edit a server's name, as well as delete the server. If you are a part of a Team, you can also share a MCP with your teammates.
+You can rename and edit a server's name, as well as delete the server. If you are a part of a Team, you can also share an MCP server with your teammates.
 
 ### Sharing MCP servers
 
 MCP servers can be shared with your teammates by clicking the share icon. When sharing, sensitive values in the `env` configuration will be automatically scrubbed and replaced with variables.
 
 <figure style={{ maxWidth: "375px" }}>
-![Sharing a MCP Server](../../../../assets/agent-platform/mcp-servers-share.png)
-<figcaption>Sharing a MCP Server.</figcaption>
+![Sharing an MCP Server](../../../../assets/agent-platform/mcp-servers-share.png)
+<figcaption>Sharing an MCP Server.</figcaption>
 </figure>
 
 Your teammates can find shared MCP servers under the `Shared` section of their MCP settings. When your teammates install your server configuration, they will be prompted to enter any scrubbed `env` values.
@@ -194,7 +194,7 @@ Most MCP servers require authentication to connect to external services. Warp su
 
 ### Debugging MCP
 
-If you're having trouble with an MCP server, you can check the logs for any errors or messages to help you diagnose the problem by clicking the `View Logs` button on a server from the MCP servers page.
+If you're having trouble with an MCP server, you can check the logs for any errors or messages to help you diagnose the problem by clicking the **View Logs** button on a server from the MCP servers page.
 
 :::caution
 If you choose to share your MCP server logs with anybody, **make sure to remove any sensitive information before sharing**, as they may contain API keys.
@@ -206,9 +206,9 @@ Many SSE based MCP servers will state that your URL should be treated like a pas
 Tip: We've noticed that some models often work better with MCP servers than others. If you're having trouble calling or using an MCP server, try using a different model.
 :::
 
-#### Debugging MCP Authentication issues
+#### Debugging MCP authentication issues
 
-In some cases you may need to reset the auth token for some MCP servers. To do this delete the local MCP auth files by running the following: `rm -rf ~/.mcp-auth`
+In some cases you may need to reset the auth token for some MCP servers. To do this, delete the local MCP auth files by running the following: `rm -rf ~/.mcp-auth`
 
 :::caution
 Note this will delete all your MCP auth tokens stored locally so you will need to login and re-authenticate.

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

@@ -24,6 +24,7 @@ Global Rules apply across all projects and contexts. They're ideal for:
 * Tool configurations or preferences you want applied everywhere
 
 Warp may also suggest Global Rules based on your usage patterns to make future interactions smarter and more consistent.
+
 ## Project Rules
 
 Project Rules live in your codebase and apply automatically when working within that project. They're stored in an `AGENTS.md` file (or `WARP.md` for backwards compatibility) and can be:
@@ -66,7 +67,7 @@ How Warp applies these Project Rules:
   * Automatically applied: `project/AGENTS.md` and `project/api/AGENTS.md`
   * Best effort: `project/ui/AGENTS.md` if editing files there
 
-### **Rules precedence**
+### Rules precedence
 
 When multiple rules apply, Warp follows this order of precedence:
 
@@ -84,8 +85,8 @@ This ensures the most specific, project-relevant rules take priority over broade
 * From the [Command Palette](/terminal/command-palette/): search for "Open AI Rules"
 * From the Settings panel: **Settings** > **Agents** > **Knowledge** > **Manage Rules**
   * Here, you can manage both Global as well as Project Rules.
-* From the macOS Menu: `AI > Open Rules`  
-* From the Slash Commands menu: `/open-project-rules`  to open Project Rules directly in Warp's code editor
+* From the Warp menu bar: **AI** > **Open Rules**
+* From the Slash Commands menu: `/open-project-rules` to open Project Rules directly in Warp's code editor
 
 <figure>
 ![Project Rules UI open in a Rules pane](../../../../assets/agent-platform/project-scoped-rules-pane.png)
@@ -110,7 +111,7 @@ This ensures the most specific, project-relevant rules take priority over broade
   * Begin indexing your codebase or display indexing status
   * Generate an `AGENTS.md` file with initial context, or
   * Link an existing Rules file to `AGENTS.md`
-    * Warp currently supports linking the following external Rules files: `CLAUDE.md`, `.cursorrules`, `AGENT.md`, `GEMINI.md`, `.clinerules`, `.windsurfrules`, `.github/copilot-instructions.md`&#x20;
+    * Warp currently supports linking the following external Rules files: `CLAUDE.md`, `.cursorrules`, `AGENT.md`, `GEMINI.md`, `.clinerules`, `.windsurfrules`, `.github/copilot-instructions.md`
 
 To view all Project Rules and open them in Warp, access it via the Warp Drive Rules pane: **Personal** > **Rules** > **Project-based**
 
@@ -130,4 +131,4 @@ When relevant, Agents automatically pull in applicable rules to guide their resp
 
 ### Rules privacy
 
-See our [Privacy Page](/support-and-community/privacy-and-security/privacy/) for more information on how we handle data with Rules.
+See our [Privacy page](/support-and-community/privacy-and-security/privacy/) for more information on how we handle data with Rules.

src/content/docs/agent-platform/capabilities/web-search.mdx

@@ -22,7 +22,7 @@ Models initiate a web search when it improves the quality or accuracy of an answ
 
 * Retrieving official documentation or API references
 * Getting the latest version of a library or tool
-* Checking error messages, GitHub issues, or StackOverflow discussions
+* Checking error messages, GitHub issues, or Stack Overflow discussions
 * Looking up ongoing incidents or recent changes
 * Answering questions where recency matters (e.g., “best approach in 2025 to…”)
 

src/content/docs/agent-platform/cli-agents/claude-code.mdx

@@ -73,7 +73,7 @@ Claude Code supports the full set of Warp's agent integration features:
 
 * [How to set up Claude Code](/guides/external-tools/how-to-set-up-claude-code/) — step-by-step setup guide
 * [Claude Code in Warp](https://www.warp.dev/agents/claude-code) — product overview
-* [Third-Party CLI Agents Overview](/agent-platform/cli-agents/overview/) — supported CLI agent integrations
+* [Third-party CLI agents overview](/agent-platform/cli-agents/overview/) — supported CLI agent integrations
 * [Claude Code with Oz](/agent-platform/cloud-agents/harnesses/claude-code/) — Claude Code as a cloud harness
 * [OpenCode](/agent-platform/cli-agents/opencode/) — OpenCode in Warp
 * [Codex](/agent-platform/cli-agents/codex/) — Codex in Warp

src/content/docs/agent-platform/cli-agents/codex.mdx

@@ -48,7 +48,7 @@ Codex supports the full set of Warp's agent integration features:
 
 * [How to set up Codex CLI](/guides/external-tools/how-to-set-up-codex-cli/) — step-by-step setup guide
 * [Codex in Warp](https://www.warp.dev/agents/codex) — product overview
-* [Third-Party CLI Agents Overview](/agent-platform/cli-agents/overview/) — supported CLI agent integrations
+* [Third-party CLI agents overview](/agent-platform/cli-agents/overview/) — supported CLI agent integrations
 * [Codex with Oz](/agent-platform/cloud-agents/harnesses/codex/) — Codex as a cloud harness
 * [Claude Code](/agent-platform/cli-agents/claude-code/) — Claude Code in Warp
 * [OpenCode](/agent-platform/cli-agents/opencode/) — OpenCode in Warp

src/content/docs/agent-platform/cli-agents/opencode.mdx

@@ -45,6 +45,6 @@ OpenCode supports the full set of Warp's agent integration features:
 
 * [How to set up OpenCode](/guides/external-tools/how-to-set-up-opencode/) — step-by-step setup guide
 * [OpenCode in Warp](https://www.warp.dev/agents/opencode) — product overview
-* [Third-Party CLI Agents Overview](/agent-platform/cli-agents/overview/)
+* [Third-party CLI agents overview](/agent-platform/cli-agents/overview/)
 * [Claude Code](/agent-platform/cli-agents/claude-code/)
 * [Codex](/agent-platform/cli-agents/codex/)

src/content/docs/agent-platform/cli-agents/remote-control.mdx

@@ -6,7 +6,7 @@ description: >-
 ---
 import VideoEmbed from '@components/VideoEmbed.astro';
 
-Remote Control lets you publish a running third-party agent session — such as Claude Code, Codex, or OpenCode — to the cloud with a single click. Once published, you can monitor progress, review output, and steer the agent from your phone, a web browser, or another computer without staying at the original machine. See [Third-Party CLI Agents](/agent-platform/cli-agents/overview/) for the full list of supported agents.
+Remote Control lets you publish a running third-party agent session — such as Claude Code, Codex, or OpenCode — to the cloud with a single click. Once published, you can monitor progress, review output, and steer the agent from your phone, a web browser, or another computer without staying at the original machine. See [Third-party CLI agents](/agent-platform/cli-agents/overview/) for the full list of supported agents.
 
 This is especially useful for long-running agent tasks. Start a coding agent, publish the session, and check back whenever you want.
 
@@ -67,5 +67,5 @@ Only you (the publisher) can revoke access or stop publishing the session.
 ## Related pages
 
 * [Agent Session Sharing](/agent-platform/local-agents/session-sharing/)
-* [Third-Party CLI Agents](/agent-platform/cli-agents/overview/)
+* [Third-party CLI agents](/agent-platform/cli-agents/overview/)
 * [Viewing Cloud Agent Runs](/agent-platform/cloud-agents/viewing-cloud-agent-runs/)

src/content/docs/agent-platform/cli-agents/rich-input.mdx

@@ -56,7 +56,7 @@ In the Warp app, go to **Settings** > **Agents** > **Third party CLI agents** to
 
 ## Related pages
 
-* [Third-Party CLI Agents Overview](/agent-platform/cli-agents/overview/)
+* [Third-party CLI agents overview](/agent-platform/cli-agents/overview/)
 * [Remote Control](/agent-platform/cli-agents/remote-control/)
 * [Voice](/agent-platform/local-agents/interacting-with-agents/voice/)
 * [Slash Commands](/agent-platform/capabilities/slash-commands/)