Skip to content
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -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 (semantic indexing and search) is not yet available in SSH or WSL sessions.**

Other coding features over SSH on macOS and Linux — file tree, native file reads, and native code diffs — already work via Warp's [SSH extension](/terminal/warpify/ssh/#installing-the-ssh-extension), and Codebase Context is on the SSH roadmap. See [Feature support over SSH](/code/ssh-feature-support/) for the current matrix.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

oo1 I don't think we need to add a section about codebase context, code review and LSP not working over SSH. They are all coming very soon


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)
Expand Down
4 changes: 4 additions & 0 deletions src/content/docs/code/code-editor/file-tree.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.
4 changes: 4 additions & 0 deletions src/content/docs/code/code-review.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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 roadmap](/code/ssh-feature-support/).
:::

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
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/code/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand Down
34 changes: 22 additions & 12 deletions src/content/docs/code/ssh-feature-support.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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 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.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tmux is not used as a fallback when user chooses to continue without installing.

It's a legacy alternative way to warpify. I think we should mention that this is not recommended anymore and is going to be deprecated


:::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:

* **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).
:::
2 changes: 1 addition & 1 deletion src/content/docs/terminal/warpify/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading
Loading