Skip to content

Commit 873b655

Browse files
hongyi-chenoz-agent
andcommitted
docs: address self-review feedback on SSH PR
- Fix Settings menu path: `Settings > Warpify` (not `Settings > Features > Warpify`) in three places (`terminal/warpify/ssh.mdx` lines 45 + 69 and `changelog/index.mdx`). Warpify is its own top-level Settings nav item per `app/src/settings_view/mod.rs:1210`, matching existing usage in `terminal/warpify/ssh-legacy.mdx:59` and `terminal/warpify/subshells.mdx:36`. - Replace fabricated `2026.04.29 (v0.2026.04.29.08.45)` changelog heading with a `### TBD (Preview)` placeholder + MDX comment pointing at the `update-changelog` skill so the real version stamp is added on release day instead of being merged as a guess. - Use descriptive `[SSH roadmap](...)` link text in `code/code-review.mdx` instead of `[SSH](...)`. - Lead the Codebase Context caution block with the specific feature that doesn't work ("semantic indexing and search") so the SSH-extension follow-up doesn't read as contradictory. - Lowercase `tmux` in the `**tmux fallback**` bullet of `code/ssh-feature-support.mdx` to match the rest of the docs. - Replace non-descriptive alt text (`SSH`) on the warpify prompt image with a descriptive alt text per the style guide. Co-Authored-By: Oz <oz-agent@warp.dev>
1 parent 5e1c3b8 commit 873b655

5 files changed

Lines changed: 13 additions & 9 deletions

File tree

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,9 +39,9 @@ Code indexed with Codebase Context is never stored on our servers. Codebase Cont
3939
:::
4040

4141
:::caution
42-
**Codebase Context doesn't work in SSH or WSL sessions yet.**
42+
**Codebase Context (semantic indexing and search) is not yet available in SSH or WSL sessions.**
4343

44-
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.
44+
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.
4545

4646
Feature requests:
4747

src/content/docs/changelog/index.mdx

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,11 @@ description: >-
77

88
Submit bugs and feature requests on our [GitHub board!](https://github.com/warpdotdev/Warp/issues/new/choose)
99

10-
### 2026.04.29 (v0.2026.04.29.08.45)
10+
{/*
11+
TODO: Replace with the dated `### YYYY.MM.DD (vX.YYYY.MM.DD.HH.MM)` heading and version stamp once the Preview release ships. The `update-changelog` skill at `.warp/skills/update-changelog/` is the canonical path for filling this in from `channel-versions`. Until then, leaving the entry under a TBD heading so the build stays clean and a fabricated version can't get merged.
12+
*/}
13+
14+
### TBD (Preview)
1115

1216
**New features**
1317

@@ -16,7 +20,7 @@ Submit bugs and feature requests on our [GitHub board!](https://github.com/warpd
1620
**Improvements**
1721

1822
* \[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.
19-
* 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).
23+
* Added the `warpify.ssh.ssh_extension_install_mode` setting (`always_ask`, `always_install`, `never_install`) under **Settings** > **Warpify** to control how the SSH extension install prompt behaves. See [All settings reference](/terminal/settings/all-settings/#ssh).
2024

2125
:::note
2226
Code Review, LSP, and Codebase Context support over SSH are still in progress and will land in subsequent Preview releases.

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import VideoEmbed from '@components/VideoEmbed.astro';
1010
## Overview
1111

1212
:::note
13-
The Code Review panel is currently local-only and is on the [SSH](/code/ssh-feature-support/) roadmap.
13+
The Code Review panel is currently local-only and is on the [SSH roadmap](/code/ssh-feature-support/).
1414
:::
1515

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

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ When you [Warpify an SSH session](/terminal/warpify/ssh/), Warp's core terminal
1010
This page documents which features are available based on which path you're on:
1111

1212
* **SSH extension** - Installed on first connect when you choose **Install Warp's SSH extension**. Available in Preview on macOS and Linux remote hosts.
13-
* **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.
13+
* **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.
1414

1515
:::note
1616
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.

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ Once the SSH extension is installed on a remote host, the following features wor
2525

2626
Further coding improvements - including Code Review, LSP, and Codebase Context over SSH - are actively in progress and will land in subsequent Preview releases.
2727

28-
![SSH](../../../../assets/terminal/warpify_ssh_prompt.png)
28+
![Warp prompting to Warpify a freshly-connected SSH session.](../../../../assets/terminal/warpify_ssh_prompt.png)
2929

3030
## Installing the SSH extension
3131

@@ -42,7 +42,7 @@ The extension binary tracks your client's release channel. Stable Warp installs
4242

4343
### Managing the install prompt
4444

45-
In the Warp app, go to **Settings** > **Features** > **Warpify** to control how the prompt behaves:
45+
In the Warp app, go to **Settings** > **Warpify** to control how the prompt behaves:
4646

4747
* **Always ask** (default) - Show the install prompt the first time you connect to each host.
4848
* **Always install** - Skip the prompt and install the extension automatically when it's missing.
@@ -66,7 +66,7 @@ Only with your explicit permission. The SSH extension installs the `oz` binary u
6666

6767
#### Can I SSH to remote machines that I don't want to Warpify?
6868

69-
Yes. Cancel the prompt to continue without Warp features, or add the host to the denylist (**Settings** > **Features** > **Warpify** > **SSH hosts denylist**) so you're never prompted again.
69+
Yes. Cancel the prompt to continue without Warp features, or add the host to the denylist (**Settings** > **Warpify** > **SSH hosts denylist**) so you're never prompted again.
7070

7171
#### Do I have to manually Warpify every time?
7272

0 commit comments

Comments
 (0)