Remote Hub

Remote Hub provides remote file management and editing for VS Code and Google Antigravity. Connect via SSH, SFTP, FTP, or FTPS to browse remote files in a native Explorer-like tree, and edit them with auto-upload on save.

SSH · SFTP · FTP · FTPS
Explorer Tree · Auto-upload · File Operations
By Felipe Almeida

Import and Export Connections

Transfer saved connections between editors or keep a backup using the Remote Hub JSON format (version 1). Open the Command Palette (Ctrl+Shift+P, or Cmd+Shift+P on macOS) to run the commands below. Both commands are also available in the Connections view toolbar.

Export connections

1. Save at least one connection by connecting successfully. To export its password later, enable Save password when connecting.
2. Run Remote Hub: Export Connections.
3. Choose Without passwords (default) or Include saved passwords.
4. Choose a destination for remote-hub-connections.json and save the file.

The export contains all saved connections. Include saved passwords only includes available passwords stored with Save password enabled. Passwords used only for the current session are not exported. Private key files and SSH host-key trust records are not included; private key paths are retained.

Security: Included passwords are written in plain text, without encryption. Keep the exported file private and delete it when no longer needed.

Import connections

1. Run Remote Hub: Import Connections in the destination editor.
2. Select a JSON file exported by Remote Hub.
3. Choose Without passwords (default) to ignore passwords in the file, or Import passwords into secure storage to save them in the editor's SecretStorage.
4. Check the notification for the number of imported connections and skipped duplicate labels. Imported connections appear in Connections.
5. Select a connection to use it. Enter its password if it was not imported, and adjust any private key path for the destination machine. Verify the SSH host-key fingerprint when prompted.

Existing connections are preserved. Matching labels are skipped, including their passwords; importing does not replace them. Duplicate labels within the file are also skipped after the first occurrence. The full document is validated before saving. If new connections would exceed the limit of 10 saved connections, the import is rejected without changing the saved list. Cancelling either dialog leaves saved connections unchanged.

Passwords selected for import are stored separately from connection metadata. Files exported without passwords remain supported, and importing never connects to a server automatically. Only the Remote Hub format is supported; JSON files from other extensions must be converted first.

Installation

Open VSX (Google Antigravity & VS Codium)

Install through the Extensions panel. Search for Remote Hub

Open VSX Registry: Remote Hub

VS Code Marketplace

Install through the Extensions panel. Search for Remote Hub

VS Code Marketplace: Remote Hub

Manual Install (.vsix)

1. Download the latest .vsix from Releases.
2. Open the Extensions panel (Ctrl+Shift+X).
3. Click ... → Install from VSIX... and select the file.

Install via command

In any compatible editor, launch Quick Open (Ctrl+P) and run:

ext install AlmeidaaFelipe.remote-hub

Quick Start

1. Open Remote Hub from the Activity Bar.
2. Create a new connection (Label, host, auth, remote path).
3. Click Connect.
4. Browse files in Explorer.
5. Open any remote file and edit normally.
6. Save and Remote Hub uploads the file automatically.

Supported Protocols

This extension supports various remote protocols depending on your needs. The following are currently supported:

ssh
sftp
ftp
ftps

Authentication

Remote Hub supports multiple authentication methods:

• Password: Optionally saved via VS Code's SecretStorage API (OS-level encrypted keychain). When "Save password" is checked, your credentials are stored securely between sessions. Otherwise, the password is only kept in memory for the current session.
• Private Key Path: Connect using a secure private key file. Supports encrypted keys with passphrase prompt.
• SSH Agent: Authentication for SSH/SFTP protocols using the system agent. Works on Linux, macOS, and Windows (OpenSSH).

On the first SSH/SFTP connection to a host and port, Remote Hub shows a SHA-256 host-key fingerprint and asks for explicit trust. Verify the fingerprint with the server administrator. Matching keys are remembered in extension storage; changed keys block the connection. After verifying a legitimate server-key change, run Remote Hub: Forget SSH Host Key from the Command Palette and reconnect. This trust registry is separate from the system known_hosts file.

Usage

Connection Behavior

• Switching to a different server disconnects the current one first. Documents, queued operations, watcher events, caches, and diff baselines are bound to a session. Old documents cannot upload to the new connection; reopen them from the current explorer.
• Up to ten saved connections are stored in globalState without passwords. Passwords are stored separately in SecretStorage when requested.
• Remote operations run sequentially. Recognized connection-loss errors trigger one reconnect attempt and one retry.

Explorer Actions

The custom Explorer view provides comprehensive file manipulation capabilities. Root connection row (Label) includes inline actions:

• New File
• New Folder

Right-click context menu on tree items includes:

• New File
• New Folder
• Copy Path
• Rename
• Delete

File Icons

Remote Hub respects your active file icon theme. If you have an icon theme installed (e.g., Material Icon Theme, vscode-icons), the remote Explorer will display the correct icons for each file type automatically.

Inline Diff (Automatic)

When you edit a remote file, Remote Hub automatically tracks changes against the original server version. The editor gutter shows colored markers:

• 🟢 Green bar — new lines added
• 🔴 Red arrow — lines deleted
• 🔵 Blue bar — lines modified

Click any gutter marker to see the inline diff popup showing the original vs. current content — identical to how Git works in VS Code.

You can also right-click any file in the Remote Explorer and select "Compare with Remote" to open a full side-by-side diff view.

After a successful upload, the diff baseline resets automatically.

Remote Search

Quickly find text across your remote server files without downloading them first!

Click the Search icon (🔍) in the Remote Explorer title bar, or right-click any folder and select "Search Remote". Enter your search term, and Remote Hub will execute a fast native search (grep) over SSH and display the results in a drop-down menu. Click any result to instantly jump to that line in the remote file. (Note: This feature requires an SSH or SFTP connection).

Drag & Drop

You can drag and drop files from your computer (e.g., Windows Explorer) directly into the Remote Hub explorer to upload them instantly. A native VS Code progress notification will keep you updated during the upload. You can also drop local folders to upload their contents recursively, including empty directories. Existing files at the destination are overwritten. Transfers run sequentially and can be cancelled between entries. Symbolic links are rejected. Drag files within the remote tree to move them between folders; moving a folder into itself or one of its descendants is prevented.

Remote Compress / Extract

Right-click any file or folder in the Remote Explorer and select "Compress Here" to create a .tar.gz archive directly on the server — no need to download anything first.

To extract, right-click a .tar.gz, .tgz, .zip, or .gz file and select "Extract Here". The contents will be extracted in the same directory on the server. (Note: This feature requires an SSH or SFTP connection. For .zip files, unzip must be available on the server).

Auto Upload

Remote Hub listens to editor save events and uploads edited remote files automatically.

Flow:

1. Open remote file (sftp://...)
2. Edit in editor
3. Save (Ctrl+S or Auto Save)
4. The filesystem provider uploads the bytes supplied by the editor and shows a progress notification
5. Status bar confirms completion; failed uploads fail the save and retain the previous diff baseline

The save listener retains a 700 ms fallback debounce for callers that bypass the filesystem write path. A filesystem-confirmed save skips the fallback upload, avoiding duplicate transfers.

File Watcher (Local → Remote Sync)

Click the eye icon (👁) in the Remote Explorer title bar to start monitoring a local folder. File events inside that folder are synced to the remote server after a 500 ms debounce per path. Starting the watcher does not upload the existing folder contents.

• A status bar item shows which folder is being watched
• Click the eye icon again (or the status bar) to stop watching
• The watcher automatically stops when you disconnect
• A warning dialog is shown before activation, since deletions are also synced
• No ignore filters are currently applied; choose the monitored folder carefully

Internationalization

Remote Hub automatically adapts to your editor's language. Currently supported:

• 🇺🇸 English (default)
• 🇧🇷 Português (Brasil)

Current limitations

• One active connection at a time; reopen remote documents after changing servers.
• SSH configuration supports a subset of directives. ProxyJump and keyboard-interactive/OTP authentication are not implemented.
• Local monitoring synchronizes subsequent events, including deletions. It does not upload existing content at startup and has no ignore filters.
• Search and archive operations require SSH/SFTP and the corresponding server tools.

Troubleshooting

• Check host, port, credentials, and network access when connecting fails.
• Verify SSH fingerprints with the administrator before trusting or resetting a host key.
• Reopen a file from the current explorer if it reports Connection changed.
• Reload the editor window if the Activity Bar or extension list retains old assets after an update.

Links

• Visual Studio Marketplace
• Open VSX Registry
• GitHub Repository
• Author Website