Remotry for VSCode
Build your project and ship it to a remote server over SSH/SFTP — without leaving the editor.

Deploy projects to remote servers over SSH/SFTP, directly from VSCode. Part of
the Remotry toolkit.
What it does
Remotry turns "build locally, then copy the output to a server" into a one-click
action. It auto-detects your stack and package manager, builds the project,
SFTP-uploads the output into a timestamped release, and atomically flips a
current symlink — so rollbacks are instant and deploys have no downtime. No
rsync, no scp, no terminal juggling.
The extension imports remotry-core
and deploys in-process — it does not shell out to the CLI, and needs no
separate remotry-cli install. It shares the same ~/.remotry/projects.json
registry as the CLI, so a project registered in either shows up in both.
Install
From the editor: Ctrl+P → paste and run
ext install coldevotion.remotry-vscode
Or install from the
VSCode Marketplace.
Features
- Sidebar panel — an activity-bar icon opens a "Deploy Projects" tree view of every registered project
- One-click deploy — inline deploy button on each tree item
- Command palette — all deploy actions via
Ctrl+Shift+P → "Deploy:"
- Register form — a WebView form to add or edit a project, prefilled from
.deployrc or auto-detection
- Auto-activation — activates on workspaces that contain a
.deployrc file
Requirements
- Node.js 18+
- An SSH key configured for the remote host
Quick start
- Click the rocket icon in the activity bar (left sidebar).
- Use Register a Project in the empty state — or
Ctrl+Shift+P → Deploy: Register / Edit Project.
- Fill in name, local path, remote (
user@host:/path), and SSH key.
- Click the deploy action on the tree item to build and ship.
Commands
| Command |
Description |
Deploy: List Projects |
List all registered projects |
Deploy: Register / Edit Project |
Add or edit a project |
Deploy: Deploy |
Build and upload to the remote |
Deploy: Status |
Show the last deploy timestamp |
Deploy: Remove Project |
Unregister a project |
Deploy: Refresh |
Refresh the tree view |
Deploy: Open Config File |
Open the config file in the editor |
Settings
| Setting |
Default |
Description |
deploy.sshKey |
~/.ssh/id_rsa |
Default SSH private key |
deploy.defaultRemoteUser |
root |
Default SSH username |
deploy.defaultRemoteBase |
/var/www |
Default remote base path |
Troubleshooting
Sidebar icon missing — reload VSCode after install (Ctrl+Shift+P → Developer: Reload Window).
Deploy fails to connect — verify the SSH key path and that the key is authorized on the remote host.
Development
pnpm install
pnpm compile # typecheck + esbuild bundle
pnpm watch # esbuild --watch
pnpm package # build the .vsix
code --install-extension remotry-vscode-*.vsix
Contributing
Contributions welcome — issues, feature requests, and PRs. See
CONTRIBUTING.md
and open an issue at
github.com/coldevotion/remotry/issues.
License
MIT — see LICENSE.