# @alhassanaraouf/paseo-remote-editor

> Composer pill to open a workspace in VS Code or Zed over SSH, desktop only.

Latest version **0.2.1** (published 2026-09-23) · MIT license · 0 weekly downloads

## Install

```sh
npm install @alhassanaraouf/paseo-remote-editor
pnpm add @alhassanaraouf/paseo-remote-editor
yarn add @alhassanaraouf/paseo-remote-editor
bun add @alhassanaraouf/paseo-remote-editor
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.2.1 |
| Published | 2026-09-23 |
| First published | 2026-09-23 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 40.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | Al-Hassan Abdel-Raouf |
| Maintainers | alhassanaraouf |
| Keywords | paseo, paseo-plugin |

## Links

- npm: https://www.npmjs.com/package/@alhassanaraouf/paseo-remote-editor
- Repository: https://github.com/alhassanaraouf/paseo-remote-editor
- Homepage: https://github.com/alhassanaraouf/paseo-remote-editor#readme
- Issues: https://github.com/alhassanaraouf/paseo-remote-editor/issues
- npm.io page: https://npm.io/package/@alhassanaraouf/paseo-remote-editor

## Recent versions

- 0.2.1 (latest) — 2026-09-23
- 0.2.0 — 2026-09-23
- 0.1.2 — 2026-09-23
- 0.1.1 — 2026-09-23

## README

# Remote Editor

Adds an **Editor** affordance you can put either in each agent's composer
("Editor" pill on the track bar) or on the workspace header ("Open in editor"
button on the right side of the header, where Paseo's own editor button lives).
The header button opens the default editor directly; the composer pill keeps
the picker so you fall back to it when no default editor is set. Both open
the relevant path directly in VS Code, Cursor, or Zed — over SSH when the
Paseo daemon runs on another machine, or as a local folder when it runs on
yours. The composer pill opens the agent's working directory; the header
button opens the workspace's directory.

Both surfaces only appear on desktop (not iOS/Android), since opening a local
editor via a deep link only makes sense from a desktop OS.

## Install

```bash
paseo plugin install npm:@alhassanaraouf/paseo-remote-editor
```

Or paste `npm:@alhassanaraouf/paseo-remote-editor` into **Settings → Plugins → Plugin source**
and select **Install plugin**.

## Settings (Remote Editor)

- **Open in** — default editor (VS Code, Cursor, Zed, or a custom editor).
- **Show button in** — where to surface the affordance: **Composer** (one pill
  per agent, default, matches the original behaviour), **Workspace header**
  (one button per workspace, placed before the built-in actions on the header's
  right side), or **Both**. The change applies immediately on the client
  where you make it; other clients of the same host pick it up after an app
  reload.
- **SSH host / user** — blank falls back to what the daemon reports
  (`os.hostname()` / `os.userInfo().username`). Set these when the daemon's hostname
  doesn't resolve locally: a Tailscale name, LAN name, or an `~/.ssh/config` alias.
- **SSH port** — appended as `:port` in Zed and custom URIs. VS Code-style URIs carry
  no port, so a non-standard port there needs an `~/.ssh/config` alias entered as the
  SSH host instead.
- **Open local paths directly** — enable when the daemon runs on this machine, so the
  editor opens the folder (`vscode://file/...`, `zed://file://...`) instead of SSH.
- **Custom editors** — add your own via URI templates using `{user}`, `{host}`,
  `{port}`, and `{path}`.

## How it works

- VS Code / Cursor: `vscode://vscode-remote/ssh-remote+<user>@<host>/<path>`
  (or `vscode://file/<path>` in local mode)
- Zed: `zed://ssh/<user>@<host>[:<port>]/<path>`
  (or `zed://file://<path>` in local mode)

`<path>` is the agent's working directory (composer pill) or the workspace's
directory (header button), percent-encoded per segment so spaces and special
characters survive the deep link.

## Limitations

- Requires the editor's remote/SSH support to already be set up, including a working
  `ssh <user>@<host>` connection from your machine.
- Not shown on iOS or Android.

---
_Source: https://npm.io/package/@alhassanaraouf/paseo-remote-editor · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._