Feature support over SSH

When you Warpify an SSH session, 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 installed on the remote host, coding features such as the file tree, the code editor, code review, codebase indexing, and native code diffs also work over SSH on macOS and Linux. The extension is installed on first connect when you choose Install Warp’s SSH extension — see Requirements for supported hosts.

Note

When a native tool isn’t available (for example, if you continue without installing the SSH extension), the Agent falls back to terminal commands (e.g. cat, sed, grep). 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 work in all Warpified remote sessions, with or without the SSH extension:

• 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 reflects the remote project structure and updates as you navigate or change files.
• Code editor — Open, view, and edit remote files in Warp’s code editor from the file tree or the Command Palette, then save back to the remote host. Warp detects conflicting changes on disk and prompts you to resolve them.
• Code review and git operations — The code review panel works on remote repositories: review diffs, discard files, commit, push, and create PRs. AI-generated commit messages and PR descriptions are produced on the remote host.
• Codebase indexing — Warp indexes the remote repository so Agents can semantically search it, the same as Codebase Context locally.
• File search — Search for remote files by name from the Command Palette.
• Project rules and skills — Agents discover and use the remote project’s rules (WARP.md) and skills.
• 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 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 are not yet available in Warpified remote (SSH) sessions:

• Language Server Protocol (LSP) — LSP features such as hover info, go-to-definition, and inline diagnostics are not available for remote files. SSH support is tracked in GitHub #6831.
• Agent orchestration — Multi-agent runs cannot be launched from a remote session; the Agent works as a single agent on the remote host.
• Computer use — The Agent cannot take screenshots or interact with the remote machine’s desktop.

Note

WSL sessions have the same limitations as SSH and are not currently covered by the SSH extension. Feature request for WSL support: GitHub #6744.