docs: Document Warp's SSH extension and feature support over SSH

Update the SSH and SSH-feature-support docs to reflect the new SSH
extension that enables file tree, native file reads, native code diffs,
and reliable multiplexed completions over SSH on macOS and Linux.
Reframe tmux Warpification as the fallback path. Embed Kevin's Loom
demo on the SSH page, refresh adjacent caveats in code/agent docs to
narrow the sed/grep fallback scope, and add a 2026.04.29 changelog
entry.

Co-Authored-By: Oz <oz-agent@warp.dev>

Author: hongyi-chen

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

@@ -38,12 +38,15 @@ When you open a directory in Warp, we check if it is part of a Git repository. I
 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.
 :::
 
-:::danger
-**Codebase Context doesn't work within SSH or WSL sessions.** \
-\
-Feature requests for support are being tracked in the following GitHub issues: \
-\- SSH: [https://github.com/warpdotdev/Warp/issues/6831](https://github.com/warpdotdev/Warp/issues/6831)\
-\- WSL: [https://github.com/warpdotdev/Warp/issues/6744](https://github.com/warpdotdev/Warp/issues/6744)
+:::caution
+**Codebase Context doesn't work in SSH or WSL sessions yet.**
+
+Warp's [SSH extension](/terminal/warpify/ssh/#installing-the-ssh-extension) already enables the file tree, native file reads, and native code diffs over SSH on macOS and Linux, and Codebase Context is on the SSH roadmap. See [Feature support over SSH](/code/ssh-feature-support/) for the current matrix.
+
+Feature requests:
+
+* SSH: [GitHub #6831](https://github.com/warpdotdev/Warp/issues/6831)
+* WSL: [GitHub #6744](https://github.com/warpdotdev/Warp/issues/6744)
 :::
 
 ![Codebase indexing settings in Warp. Easily track sync status and manage which folders are indexed for AI-powered context and suggestions.](../../../../assets/agent-platform/codebase-context-main.png)

src/content/docs/changelog/index.mdx

@@ -7,6 +7,21 @@ description: >-
 
 Submit bugs and feature requests on our [GitHub board!](https://github.com/warpdotdev/Warp/issues/new/choose)
 
+### 2026.04.29 (v0.2026.04.29.08.45)
+
+**New features**
+
+* \[Preview] Warp's new **SSH extension** brings the local Warp experience to remote macOS and Linux hosts. On first connect, choose **Install Warp's SSH extension** to enable a real file tree backed by the remote filesystem and have the coding agent apply edits via Warp's native diff tool instead of `sed`. Choose **Continue without installing** to fall back to the existing tmux-powered Warpification path. See [SSH with Warp features](/terminal/warpify/ssh/) and [Feature support over SSH](/code/ssh-feature-support/).
+
+**Improvements**
+
+* \[Preview] Completions and autosuggestions over SSH are now multiplexed through the SSH extension over a single connection. This eliminates the remote host's `MaxSessions` ceiling, lets generators run in parallel, and removes the occasional errors that the previous per-command SSH session approach injected into blocks.
+* Added the `warpify.ssh.ssh_extension_install_mode` setting (`always_ask`, `always_install`, `never_install`) under **Settings** > **Features** > **Warpify** to control how the SSH extension install prompt behaves. See [All settings reference](/terminal/settings/all-settings/#ssh).
+
+:::note
+Code Review, LSP, and Codebase Context support over SSH are still in progress and will land in subsequent Preview releases.
+:::
+
 ### 2026.04.22 (v0.2026.04.22.08.46)
 
 **New features**

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

@@ -9,6 +9,10 @@ description: >-
 
 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.
 
+:::note
+The file tree also works over SSH on macOS and Linux when Warp's [SSH extension](/terminal/warpify/ssh/#installing-the-ssh-extension) is installed on the remote host.
+:::
+
 ### Opening the file tree
 
 You can open the file tree from the tools panel on the left hand side:

src/content/docs/code/code-editor/language-server-protocol.mdx

@@ -82,7 +82,7 @@ LSP features stay in sync across [shared buffers](/code/code-editor/#shared-buff
 
 ## Limitations
 
-* **Local sessions only** - LSP is not available over SSH or WSL sessions. These are tracked in GitHub issues [#6831](https://github.com/warpdotdev/Warp/issues/6831) (SSH) and [#6744](https://github.com/warpdotdev/Warp/issues/6744) (WSL).
+* **Local sessions only** - LSP is not yet available over SSH or WSL sessions; SSH support is on the roadmap. See [Feature support over SSH](/code/ssh-feature-support/) for the current matrix. Tracked in GitHub issues [#6831](https://github.com/warpdotdev/Warp/issues/6831) (SSH) and [#6744](https://github.com/warpdotdev/Warp/issues/6744) (WSL).
 * **One server per language** - Each language maps to a single server (for example, Rust always uses `rust-analyzer`). Custom server configurations are not yet supported.
 * **Project-scoped** - Language servers operate at the Git repository root level. Files outside a repository may not receive LSP features.
 * **Server availability** - Some features (like formatting) depend on the specific language server's capabilities. Not all servers support all features.

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

@@ -9,6 +9,10 @@ import VideoEmbed from '@components/VideoEmbed.astro';
 
 ## Overview
 
+:::note
+The Code Review panel is currently local-only and is on the [SSH](/code/ssh-feature-support/) roadmap.
+:::
+
 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:
 
 * Review diffs and attach them as context for the Agent

src/content/docs/code/overview.mdx

@@ -7,7 +7,7 @@ description: >-
 import VideoEmbed from '@components/VideoEmbed.astro';
 
 :::note
-Several coding features — including Codebase Context, code diffs, the code editor, and the file tree — are not yet available in SSH or WSL sessions.
+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. Codebase Context, Code Review, and LSP support are still local-only — see [Feature support over SSH](/code/ssh-feature-support/).
 :::
 
 ## From prompt to production
@@ -34,7 +34,7 @@ Warp’s coding agent is designed to help you generate, edit, and manage code di
 <VideoEmbed url="https://youtu.be/W8rCsznM5HA" title="Coding Features Overview" />
 
 :::note
-Warp's coding agent only works on local repositories. The agent can make changes on remote or docker repositories, but falls back to using terminal commands (i.e. `sed`, `grep` ) to make the changes.
+With the [SSH extension](/terminal/warpify/ssh/#installing-the-ssh-extension) installed on a remote macOS or Linux host, the coding agent applies edits using Warp's native diff tool over SSH. In sessions where the extension isn't available (Windows clients, declined installs, or Docker-backed sessions), the agent falls back to terminal commands (i.e. `sed`, `grep`) to make changes.
 :::
 
 ### Examples of coding capabilities

src/content/docs/code/ssh-feature-support.mdx

@@ -5,34 +5,44 @@ description: >-
   are limited to local sessions.
 ---
 
-When you [Warpify an SSH session](/terminal/warpify/ssh/), Warp's core terminal features — the input editor, completions, blocks, history search, and more — work the same as they do locally. However, several coding-specific features are **not yet available** in remote sessions because the Agent cannot directly access the remote filesystem.
+When you [Warpify an SSH session](/terminal/warpify/ssh/), Warp's core terminal features — the input editor, completions, blocks, history search, and more — work the same as they do locally. With Warp's [SSH extension](/terminal/warpify/ssh/#installing-the-ssh-extension) installed on the remote host, additional coding features such as the file tree, native file reading, and native code diffs also work over SSH on macOS and Linux.
+
+This page documents which features are available based on which path you're on:
+
+* **SSH extension** - Installed on first connect when you choose **Install Warp's SSH extension**. Available in Preview on macOS and Linux remote hosts.
+* **Tmux fallback** - Used when you choose **Continue without installing**, when the extension hasn't shipped to your build (for example, Windows clients), or when the install fails.
 
 :::note
-When a native tool is unavailable, the Agent automatically falls back to terminal commands (e.g. `cat`, `sed`, `grep`) to read and edit files. You can still accomplish most coding tasks over SSH, but the experience may be less seamless than working locally.
+In the tmux fallback path, the Agent automatically falls back to terminal commands (e.g. `cat`, `sed`, `grep`) when a native tool is unavailable. You can still accomplish most coding tasks, but the experience is less seamless than working locally or through the SSH extension.
 :::
 
 ## Features that work over SSH
 
-The following features are fully available in Warpified remote sessions:
+The following features work in Warpified remote sessions on both paths:
 
-* **Agent Mode conversations** — You can chat with the Agent, ask questions, and request code changes. The Agent will use terminal commands to interact with the remote filesystem.
+* **Agent Mode conversations** — Chat with the Agent, ask questions, and request code changes on the remote host.
 * **Running shell commands** — The Agent can execute commands on the remote machine on your behalf.
 * **Grep and file glob** — The Agent can search for files and patterns using terminal-based grep and glob tools.
 * **MCP tools** — Model Context Protocol integrations remain available.
 * **Terminal features** — The input editor, command completions, autosuggestions, command history, blocks, and all other core terminal features work as expected.
 
+The following features require the **SSH extension**:
+
+* **File tree (Project Explorer)** — The [file tree sidebar](/code/code-editor/file-tree/) reflects the remote project structure and updates as you navigate or change files.
+* **Native file reading** — The Agent reads remote files through Warp's built-in file reading tool instead of shelling out to `cat`.
+* **Native code diffs** — The Agent applies edits as inline [code diffs](/agent-platform/local-agents/code-diffs/) you can review and approve, instead of using `sed` or other shell commands.
+* **Reliable, parallel completions** — Generators run in parallel over a single multiplexed connection, so completions stop hitting the remote host's `MaxSessions` ceiling and stop occasionally injecting errors into your blocks.
+
 ## Features not yet available over SSH
 
-The following features require local filesystem access and are not yet available in Warpified remote (SSH) sessions:
+The following features require local filesystem access and are not yet available in Warpified remote (SSH) sessions on either path. Each is on the SSH roadmap:
 
-* **Codebase Context (indexing and search)** — Warp cannot index or semantically search a remote codebase. The Agent will not have access to your full project context when generating responses. Feature request: [GitHub #6831](https://github.com/warpdotdev/Warp/issues/6831)
-* **Native file reading** — The Agent cannot read files through Warp's built-in file reading tool. It falls back to terminal commands like `cat` to read file contents.
-* **Code diffs** — The Agent cannot apply code diffs natively. It falls back to terminal commands like `sed` to make file edits.
-* **Code editor** — Warp's [native code editor](/code/code-editor/) is not yet available in remote sessions. You cannot open, view, or edit files in Warp's built-in editor over SSH.
-* **File tree (Project Explorer)** — The [file tree sidebar](/code/code-editor/file-tree/) is not yet available in remote sessions.
-* **Code review panel** — The [Code Review](/code/code-review/) panel for reviewing Git diffs is not yet available for remote repos.
+* **Codebase Context (indexing and search)** — Warp cannot yet index or semantically search a remote codebase. The Agent does not have access to your full project context when generating responses. Tracked in [GitHub #6831](https://github.com/warpdotdev/Warp/issues/6831).
+* **Code Review panel** — The [Code Review](/code/code-review/) panel for reviewing Git diffs is not yet available for remote repos.
+* **Language Server Protocol (LSP)** — Warp's [LSP integration](/code/code-editor/language-server-protocol/) (hover info, go-to-definition, diagnostics, format-on-save) is local-only.
+* **Code editor (file open/edit UI)** — Warp's [native code editor](/code/code-editor/) is not yet available in remote sessions. You cannot open, view, or edit remote files in Warp's built-in editor.
 * **Computer use** — The Agent cannot take screenshots or interact with the remote machine's desktop.
 
 :::note
-WSL sessions have the same limitations as SSH. Feature request for WSL support: [GitHub #6744](https://github.com/warpdotdev/Warp/issues/6744)
+WSL sessions have the same limitations as SSH and are not currently covered by the SSH extension. Feature request for WSL support: [GitHub #6744](https://github.com/warpdotdev/Warp/issues/6744).
 :::

src/content/docs/terminal/warpify/index.mdx

@@ -7,7 +7,7 @@ description: >-
 import DemoVideo from '@components/DemoVideo.astro';
 
 1. [Subshells](/terminal/warpify/subshells/), Warp supports enabling Warp features in subshells for bash, zsh, and fish.
-2. [SSH](/terminal/warpify/ssh/), Warp supports a tmux powered wrapper that enables Warp features in remote (SSH) sessions.
+2. [SSH](/terminal/warpify/ssh/), Warp's SSH extension brings the file tree, reliable completions, and native code diffs to remote macOS and Linux hosts, with a tmux-powered fallback for the rest.
 3. [SSH Legacy](/terminal/warpify/ssh-legacy/), Warp supports a legacy wrapper that enables Warp features in remote (SSH) sessions.
 
 ## Subshells