Remote File Browser Extension

Edit remote files seamlessly in VSCode/Cursor with instant access and automatic sync. No more downloading entire directories or juggling multiple tools.

✨ Key Features

🚀 Instant File Access - Open remote files directly in your editor without downloading entire directory structures

🔄 Auto-Sync on Save - Changes automatically upload to your server when you hit Ctrl+S / Cmd+S

🔐 Secure Authentication - Full support for SSH keys (OpenSSH & PuTTY PPK v2/v3) with revolutionary RSA-SHA2 compatibility for modern SSH servers, password auth, and secure credential storage

📁 Complete File Management - Rename, move, copy, and delete files/directories directly on the remote server

⬆️ One-Click File Upload - Push local files to remote servers with a simple right-click menu

🌐 Multiple Protocol Support - Works with SFTP, FTP, and secure FTPS (FTP over TLS) connections, including anonymous FTP

⚡ Quick Connect - Save multiple server configurations and connect with a single click

🗂️ Smart File Organization - Organized temporary file storage prevents conflicts between different servers

🖥️ Intuitive GUI Interface - Beautiful, user-friendly connection manager with visual forms instead of complex configuration files

🎯Context Menu Integration - All operations available via right-click menus and command palette

⚠️ Overwrite Protection - Built-in safeguards prevent accidental file replacement

📊 Enhanced Connection Progress - Real-time progress tracking with percentage indicators and advanced file transfer monitoring

🚀 Revolutionary Performance - Powered by pure-js-sftp 5.0.0 with 4x faster transfers (20+ MB/s), automatic server adaptation, and intelligent reconnection

🔇 Non-Intrusive Notifications - Smart notification system that uses status bar messages instead of disruptive popups

🛡️ Operation Protection - Advanced concurrent operation prevention system protects against duplicate file operations and connection conflicts

Getting Started

Initial Setup

Open the Remote File Browser
- Click the globe icon (🌐) in the activity bar on the left side of your editor
Add Your First Connection
- Click "Manage Connections" in the welcome screen
- Click the green "➕ Add New Connection" button to show the connection form
- Fill out the connection form:
  - Connection Name: A friendly name for your server
  - Protocol: SFTP (recommended), FTP, or secure FTPS
  - Host: Your server's IP address or domain name
  - Port: Usually 22 for SFTP, 21 for FTP, or 990 for implicit FTPS
  - Username: Your server username (optional for anonymous FTP)
  - Authentication: Choose Password or SSH Key (SFTP only - supports OpenSSH and PuTTY .ppk v2/v3 formats)
  - Password: Optional - enter to store securely, or leave empty to prompt during connection
  - Anonymous FTP: Check this box for anonymous FTP access (FTP only)
  - FTPS Security: For FTP connections, enable FTPS for encrypted TLS connections (Explicit/Implicit modes)
  - Remote Path: Starting directory (usually /)
Save and Connect
- Click "Add Connection" to save (the form will automatically hide after saving)
- Click the "Connect" button next to your new connection
- If no password was stored, you'll be prompted to enter it
- Choose "Yes" to save credentials securely for future connections

Enhanced Connection Experience

Visual Connection Progress

When connecting to servers, you'll see clear visual feedback:

Status Bar Progress: Detailed connection stages appear in the status bar:
- "⟳ Establishing connection to [host]..."
- "⟳ Authenticating to [host]..."
- "⟳ Loading file structure from [host]..."
- "✓ Connected to [host]" (briefly, then shows persistent connected state)
Welcome View Spinners: Connection items show spinning indicators during connection attempts
Persistent Connected State: Once connected, the status bar shows "⚡ [host] ✖" with:
- Click anywhere to disconnect immediately
- Tooltip: "Connected to [host] - Click to disconnect"
- Remains visible until disconnected

Non-Intrusive Notifications

The extension uses smart notification management:

Status Bar Messages: Success operations (file uploads, connections, etc.) appear briefly in the status bar instead of popup dialogs
Critical Alerts Only: Error messages, confirmations, and safety warnings still use popups when user attention is required
Auto-Dismiss: Status bar messages automatically disappear after 3-5 seconds
Examples of Status Bar Messages:
- "Password saved securely"
- "filename.txt (45%)" (real-time upload progress)
- "Uploaded filename.txt" (completion notification)
- "Pushed filename.txt"
- "Connection deleted"
- "Cleaned up 5 temp files"
- "Renamed to newname.txt"
- "Moved to foldername"
- "Copied to filename.txt"

Retry and Error Handling

Connection Retries: Failed connections automatically retry with exponential backoff
Status Updates: Retry attempts show "⟳ Retrying connection to [host] (2/3)..."
Smart Error Recovery: Authentication failures offer retry options with new credentials

Connection Management

Smart Connection State Management

The connection manager now provides intelligent connection handling:

Visual Connection State: Currently connected servers are highlighted with a green border and "● Connected" indicator
Smart Connect/Disconnect Buttons:
- When not connected: Shows "Connect" button
- When connected: Shows red "Disconnect" button
Connection Switching: When trying to connect to a different server while already connected:
- Shows confirmation dialog: "Disconnect from [current] and connect to [new]?"
- Automatically disconnects first, then connects to new server
- Prevents accidental connection switching
Same Connection Protection: Clicking "Connect" on the already-connected server shows "Already connected" message
Connection Manager Stays Open: Window remains open after connecting for easy server switching

Cloning Connections

Click "Clone" button next to any saved connection to duplicate it
Cloned connections are automatically prefixed with "copy of "
Perfect for setting up similar server environments (dev, staging, production)
Edit the cloned connection to customize host, port, or other settings

Daily Usage

Quick Connect

Click the globe icon (🌐) to see your saved connections
Expand "Existing Connections" to see all saved servers (sorted alphabetically)
Single-click any connection name to connect instantly (double-clicking is not necessary)
Right-click options:
- Manage Connections item: Right-click to access "Add New Connection" option
- Individual connections: Right-click for "Edit Connection", "Clone", and "Delete Connection" options

Browsing Files

Once connected, browse files in the "Remote Files" tree view
Folders show first, then files (both alphabetically sorted)
Double-click any file to open and edit it
Use the arrow-up button (⬆️) in the toolbar to navigate to parent directories
Select directories in the tree to use as upload destinations for local files

💡 Tip: Better Tree Indentation If nested folders are hard to see, increase VSCode's tree indentation:

Open Settings (Ctrl+, / Cmd+,)
Search for "tree indent"
Change "Workbench › Tree: Indent" from 8 to 16 or 20 pixels
This improves visibility for all tree views in VSCode!

💡 Tip: Customizing File Opening Behavior Some users prefer different file opening behaviors. You can customize these in VSCode settings:

Open Settings (Ctrl+, / Cmd+,)
Disable Preview Tabs: Search for "workbench.editor.enablePreview" and set it to false
- This prevents files from opening in preview mode (italic tab names)
- Every file click will open in a permanent tab instead
Require Double-Click: Search for "workbench.list.openMode" and change it to "doubleClick"
- This requires double-clicking to open files instead of single-clicking
- Applies to all tree views in VSCode, not just Remote File Browser
These settings affect all VSCode file operations, providing a consistent experience across the editor

Editing Files

Files open instantly in your editor
Make changes and save normally (Ctrl+S / Cmd+S)
Changes are automatically uploaded to the remote server with 4x faster speeds
Real-time progress tracking: "filename.txt (45%)" during uploads
Status bar confirmation: "Uploaded filename.txt" upon completion
Clean status transitions: No more stuck or duplicate status messages

Uploading Local Files to Remote Server

Open any local file in VSCode/Cursor
Right-click on the file tab at the top of the editor
Select "Push to Remote" from the context menu

Smart Upload Destinations

Regular local files: Upload directly to currently selected directory in remote tree
Temporary files (from /tmp/): Get choice between two destinations:
- "Original Location": Upload back to where the file was originally downloaded from
- "Current Location": Upload to currently selected directory in remote tree
Note: For regular files, you must first select a directory in the remote file tree as the upload destination

File Operations via Right-Click Context Menu

All file operations are available by right-clicking on files or directories in the remote file tree. The context menu provides:

"Open" - Open the file in the editor (same as double-clicking)
"Rename" - Rename the file or directory
"Move" - Move the file or directory to a new path
"Copy" - Copy the file or directory to a new location
"Delete" - Delete the file or directory from the server

Renaming and Deleting Remote Files

You can rename or delete files and directories directly on the remote server:

Renaming Files or Directories

Right-click on any file or directory in the remote file tree
Select "Rename" from the context menu
Enter the new name in the input box that appears
Press Enter to confirm or Escape to cancel
The file or directory will be renamed on the remote server

Deleting Files or Directories

Right-click on any file or directory in the remote file tree
Select "Delete" from the context menu
Confirm the deletion in the warning dialog that appears
For directories: You'll be warned that all contents will be deleted recursively
The file or directory will be permanently deleted from the remote server

⚠️ Warning: Deleted files and directories cannot be recovered. Use caution when deleting.

Moving Files and Directories

Right-click on any file or directory in the remote file tree
Select "Move" from the context menu
Edit the path in the input dialog (pre-populated with current path)
Press Enter to confirm the move operation
Overwrite Protection: If a file already exists at the target location, you'll be prompted to "Overwrite" or "Cancel"
The file or directory will be moved to the new location on the remote server
If the file is currently open in your editor, the tab will automatically update to reflect the new path

📝 Move Features:

Pre-populated paths save you from typing the full path again
Real-time validation prevents invalid moves (empty paths, circular directory moves, etc.)
Overwrite protection prevents accidental file replacement with confirmation dialog
Smart error handling with helpful suggestions when moves fail
Editor tab updates automatically when moving open files
Progress notifications show move status and completion

Common Move Examples:

Move /var/www/app.php to /var/www/backup/app.php (same filename, different directory)
Move /home/user/temp.txt to /home/user/documents/notes.txt (rename and move)
Move /project/old-folder/ to /project/archive/old-folder/ (move entire directory)

Copying Files and Directories

Right-click on any file or directory in the remote file tree
Select "Copy" from the context menu
Edit the target path in the input dialog (pre-populated with current path)
Press Enter to confirm the copy operation
Overwrite Protection: If a file already exists at the target location, you'll be prompted to "Overwrite" or "Cancel"
The file or directory will be copied to the new location on the remote server
For files: The copied file will automatically open in a new editor tab alongside the original

📝 Copy Features:

Pre-populated paths save you from typing the full path again
Real-time validation prevents invalid copies (empty paths, circular directory copies, etc.)
Overwrite protection prevents accidental file replacement with confirmation dialog
Smart error handling with helpful suggestions when copies fail
New tab behavior opens copied files in separate tabs from originals
Progress notifications show copy status and completion
Recursive directory copying handles entire folder structures with all contents

Common Copy Examples:

Copy /var/www/app.php to /var/www/backup/app.php (backup existing file)
Copy /home/user/config.txt to /home/user/config-backup.txt (create backup copy)
Copy /project/template/ to /project/new-site/ (duplicate entire directory structure)

Switching Servers

You can disconnect and switch servers in multiple ways:

Status Bar: Click the persistent connection indicator "⚡ [host] ✖" in the status bar
Remote Files View: Click the X (disconnect) button in the remote files toolbar
Command Palette: Use "Remote File Browser: Disconnect from Remote Server"
Welcome View: Simply click a different connection to automatically disconnect and reconnect

Disconnect Feedback: When disconnecting, you'll see a brief "Disconnecting from [host]" status message before the status bar clears, providing clear confirmation that the disconnection was successful.

Anonymous FTP Support

Remote File Browser fully supports anonymous FTP connections for public file servers.

Setting Up Anonymous FTP

In the connection form, select FTP as the protocol
Check the "Anonymous FTP Connection" checkbox
Username/Password: Optional - you can:
- Leave both fields empty (extension uses default anonymous credentials)
- Enter custom username/password if the server requires specific anonymous credentials
Host and Port: Enter the FTP server details as normal
Save and connect

Anonymous FTP Features

Flexible Authentication: Works with servers that require empty credentials or specific anonymous usernames
No Credential Storage: Anonymous connections don't prompt to save passwords
Standard Operations: Full support for browsing, downloading, uploading, and file management
Auto-Detection: Extension automatically handles common anonymous FTP patterns

Authentication Error Recovery

If you encounter authentication failures, the extension provides smart recovery options:

For Password Authentication

Retry Prompt: When authentication fails, you'll get an option to "Retry with different password"
Secure Storage: Option to save the corrected password securely for future connections
Graceful Fallback: If you cancel the retry, the original error is shown without losing context

For SSH Key Authentication

Passphrase Recovery: If key decryption fails, you'll be prompted for the correct passphrase
Secure Passphrase Storage: Option to save passphrases securely in your OS keychain
PPK Support: Full error handling for PuTTY PPK v2/v3 key format issues

Connection Manager Features

Adding SSH Key Authentication

In the connection form, select "SSH Key" for authentication
Click "Browse..." to select your private key file
Supports OpenSSH (.key, .pem) and PuTTY PPK v2/v3 (.ppk) key formats
Usually located in ~/.ssh/id_rsa or C:\Users\Username\.ssh\
Enter the key passphrase if your key is encrypted
Save the connection and connect

PPK Key Format Compatibility

✅ Fully Supported: Both PuTTY PPK version 2 and version 3 keys

PPK v2: Generated by PuTTY 0.52-0.74
PPK v3: Generated by PuTTY 0.75+

All PPK files are automatically converted to OpenSSH format in memory - no manual conversion required! Simply select your .ppk file and it will work regardless of version.

Enhanced SSH Compatibility

Revolutionary RSA-SHA2 Support: Powered by pure-js-sftp 5.0.0 with breakthrough compatibility fixes:

✅ 100% RSA Key Compatibility with modern SSH servers (OpenSSH 8.2+)
✅ Automatic Algorithm Upgrade from legacy RSA-SHA1 to modern RSA-SHA2-256
✅ Zero Configuration Required - compatibility fixes applied automatically
✅ Backward Compatible with legacy SSH servers
✅ Enhanced Security using modern cryptographic signatures

Managing Connections

Adding New Connections

From Connection Manager: Click the green "➕ Add New Connection" button
From Welcome Screen: Right-click "Manage Connections" → select "Add New Connection"
Both methods open the connection manager with the form ready for input
The form automatically hides after successfully saving a connection

Editing and Deleting Connections

Edit:
- Click "Edit" next to any connection in the connection manager
- Or right-click any connection in the welcome screen → "Edit Connection"
- Both methods open the connection manager with the selected connection pre-loaded
Delete:
- Click "Delete" next to any connection in the connection manager
- Or right-click any connection in the welcome screen → "Delete Connection"
- Both methods show a confirmation dialog before deletion
Connect: Click "Connect" to establish connection immediately

Form Behavior

Hidden by Default: The connection form is hidden when you first open the connection manager
Smart Visibility: The form appears when adding or editing connections
Auto-Hide: The form automatically hides after successful operations or when canceled
Button Management: The "Add New Connection" button is hidden when the form is active to reduce clutter

Temporary File Management

View Temp Files: Click "💻 View tmp files in shell" to see downloaded files
Clean Up: Click "🗑️ Clean Up Temp Files" to delete all temporary files

Navigation and File Upload Features

Parent Directory Navigation

Button Access: Click the arrow-up button (⬆️) in the remote files toolbar to go up one directory level
Command Palette: Use Ctrl+Shift+P / Cmd+Shift+P → "Remote File Browser: Go to Parent Directory"
Quick Navigation: Navigate from /var/www/html/ to /var/www/ to /var/ to / (root)
Context Aware: Button only appears when navigation up is possible (not at root directory)

Push Local Files to Remote Server

Follow these steps to upload local files to your remote server:

Select Destination Directory:
- In the remote file tree, click on a folder to select it as your upload destination
- The selected folder will be highlighted
Upload a Local File:
- Open any local file in VSCode/Cursor
- Right-click on the file tab (the tab at the top showing the file name)
- Select "Push to Remote" from the context menu
- The file will be uploaded to your selected remote directory
View Progress:
- Real-time progress with percentage: "filename.txt (67%)"
- Enhanced transfer speeds up to 20+ MB/s for large files
- Automatic server adaptation and intelligent reconnection for reliability
- Status bar confirmation: "Pushed filename.txt" upon completion
- Clean status transitions with proper connection timing
- The remote file tree will refresh to show your uploaded file

Requirements:

Must be connected to a remote server
Must have a directory selected in the remote file tree
Local file must exist and be readable

Operation Protection Features

Concurrent Operation Prevention

The extension includes advanced protection against duplicate and conflicting operations:

Connection Protection

Prevents multiple connection attempts: If a connection is already in progress, additional attempts are silently ignored
Connection state management: Proper handling of connection timing to prevent "SFTP connection is not ready" errors
SFTP connection timing: Waits for connectionReady event before allowing file operations
Clean disconnection: All operation locks are cleared when disconnecting

File Operation Protection

Prevents concurrent file operations: Each file operation (read, write, delete, rename) is protected by operation-specific locks
Operation types protected:
- read:filename.txt - Prevents multiple downloads of the same file
- write:filename.txt - Prevents multiple uploads to the same file
- delete:filename.txt - Prevents multiple deletion attempts
- rename:oldname.txt - Prevents multiple rename operations
Clear error messages: "File operation already in progress" when attempting duplicate operations
Automatic cleanup: Operation locks are automatically released when operations complete or fail

VSCode Preview Mode Compatibility

Handles rapid clicks: Protects against VSCode's workbench.editor.enablePreview causing multiple file operations
Single-click protection: Prevents issues when single-clicking files rapidly in preview mode
Double-click protection: Guards against accidental double-clicking triggering duplicate operations

Benefits

No duplicate status messages: Eliminates "downloading, downloaded, downloading..." cycles
Prevents data corruption: Stops multiple writes to the same file from conflicting
Improves reliability: Reduces connection errors and timing issues
Better user experience: Clean, predictable operation behavior

💡 Tip: If you encounter "File operation already in progress" errors, simply wait a moment for the current operation to complete before trying again.

Advanced Features

Command Palette Commands

Access these via Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac):

Remote File Browser: Connect to Remote Server - Manual connection setup
Remote File Browser: Connect from Saved Configuration - Quick picker for all connections
Remote File Browser: Manage Connections - Open connection manager
Remote File Browser: Clean Up Connection Temp Files - Delete temp files for current connection only
Remote File Browser: Clean Up All Temp Files - Delete temp files for all connections
Remote File Browser: Disconnect from Remote Server - Close current connection
Remote File Browser: Refresh - Reload remote file tree
Remote File Browser: Push to Remote - Upload current local file to selected remote directory
Remote File Browser: Go to Parent Directory - Navigate up one directory level
Remote File Browser: Rename File - Rename selected file or directory on remote server
Remote File Browser: Move File - Move selected file or directory to a new path on remote server
Remote File Browser: Copy File - Copy selected file or directory to a new path on remote server
Remote File Browser: Download File - Download and open selected remote file in editor (same as double-clicking)
Remote File Browser: Delete File - Delete selected file or directory from remote server

Settings Configuration

Advanced users can directly edit settings in VSCode/Cursor settings:

Open Settings (Ctrl+, / Cmd+,)
Search for "Remote File Browser"
Edit the remoteFileBrowser.connections array directly

Example configuration:

{
  "remoteFileBrowser.connections": [
    {
      "name": "Production Server",
      "protocol": "sftp",
      "host": "prod.example.com",
      "port": 22,
      "username": "deploy",
      "remotePath": "/var/www",
      "authType": "key",
      "keyPath": "/home/user/.ssh/id_rsa",
      "connectionTimeout": 20000,
      "operationTimeout": 90000
    }
  ]
}

Note: Timeout parameters are optional. If not specified, sensible defaults are used:

Connection timeouts: 20s (SFTP), 30s (FTP)
Operation timeout: 60s
Retry logic and keep-alive are handled automatically by the underlying connection libraries

How Temporary Files Work

File Storage Structure

When you open remote files, they're downloaded to your local system in an organized structure:

/tmp/remote-file-browser/
├── user-at-server1-22/
│   ├── home/user/config.txt
│   ├── etc/nginx/nginx.conf
│   └── var/log/app.log
└── admin-at-server2-21/
    └── web/index.html

Connection-Specific Directories

Each connection gets its own folder named username-at-hostname-port
The remote directory structure is preserved locally
This prevents filename conflicts between different servers

File Caching Behavior

First Open: File is downloaded from the remote server
Subsequent Opens: You're asked to choose:
- "Override with fresh copy from server" - Downloads latest version
- "Open existing local copy" - Uses cached version
- "Cancel" - Closes the dialog

Auto-Sync on Save

When you save a file (Ctrl+S / Cmd+S), changes are automatically uploaded
You'll see a status bar confirmation: "Uploaded filename.txt"
If upload fails, you'll see an error popup with details

Managing Temporary Files

Viewing Temp Files

Open the connection manager (click globe icon → "Manage Connections")
Click "💻 View tmp files in shell"
A terminal opens in the temp directory showing all downloaded files
Use standard shell commands to explore: ls -la, cd, cat, etc.

Cleaning Up Temp Files

Clean Up Current Connection Files

Warning: This will delete temporary files for the current connection and break sync for any open files from this server.

Via Navigation Bar (when connected):
- Click the trash icon (🗑️) next to refresh and disconnect
- This runs "Clean Up Connection Temp Files"
Via Command Palette:
- Press Ctrl+Shift+P / Cmd+Shift+P
- Type "Clean Up Connection Temp Files" and select it

Clean Up All Connection Files

Warning: This will delete ALL temporary files from ALL connections and break sync for any open files.

Via Connection Manager:
- Click "🗑️ Clean Up Temp Files" in the connection manager
- This runs "Clean Up All Temp Files"
Via Command Palette:
- Press Ctrl+Shift+P / Cmd+Shift+P
- Type "Clean Up All Temp Files" and select it

What Cleanup Does

Deletes the entire /tmp/remote-file-browser/ directory
Removes all downloaded files from all connections
Clears file watchers to prevent memory leaks
Shows status bar message with count of deleted files

After Cleanup

Any files you have open will no longer sync when saved
Next time you open a remote file, it will be downloaded fresh
Your saved connections and credentials remain intact

Troubleshooting

Connection Issues

"All configured authentication methods failed": Check username/password or SSH key path
"Connection refused": Verify host, port, and that SSH/FTP service is running
"Host key verification failed": Accept the host key when prompted
"Failed to convert PPK file": Check that your PPK file is valid and enter the correct passphrase if the key is encrypted

Keyring Issues (Linux)

If you see "keyring couldn't be identified":

Install a keyring manager: sudo apt install gnome-keyring (Ubuntu) or similar
Or choose "Continue Without Saving" to skip credential storage

Temp File Access Issues

Crostini/ChromeOS: Temp files are in the Linux container, use the shell interface
File not syncing: Check if you cleaned up temp files, re-open the file to re-establish sync
Permission errors: Ensure you have write access to the remote directory

Security Notes

Credentials: Stored securely in your OS keychain (not in settings files)
SSH Keys: Read from disk only during connection, not cached in memory
PPK Files: PuTTY .ppk files (v2 and v3) are converted to OpenSSH format in memory for security
Temp Files: Use sanitized names to prevent path traversal attacks
Network: All connections use standard SFTP/FTP protocols with your authentication

⚠️ Multi-Window Limitations

Important: Be careful when using multiple VSCode/Cursor windows with this extension to avoid data loss.

Known Issues

Same Server Conflicts: Multiple windows connecting to the same server share temp file storage, which can cause file conflicts
Data Loss Risk: If two windows edit the same remote file, whichever saves last will overwrite the other's changes
Sync Disruption: Running "Clean Up All Temp Files" in one window stops file synchronization in ALL windows; "Clean Up Connection Temp Files" only affects the current connection

How to Avoid Problems

✅ Safe Usage Patterns:

Use only one window per remote server
Connect different windows to different servers
Use different user accounts on the same server from different windows

❌ Avoid These Scenarios:

Two windows connected to user@production-server.com
Opening the same file (/app/config.php) from multiple windows
Running temp file cleanup while other windows have active connections

If You Must Use Multiple Windows

Coordinate file access - Don't edit the same files simultaneously
Avoid cleanup operations - Don't run "Clean Up All Temp Files" while other windows are active
Save frequently - Minimize time between edits to reduce conflict windows
Check for conflicts - If sync stops working, disconnect and reconnect

Future versions will include better multi-window isolation to prevent these issues.

Installation

Manual Installation (Cursor Users)

For Cursor users, you can install this extension manually using the pre-built VSIX package:

Download the VSIX package:
- Download remote-file-browser-latest.vsix from the GitHub repository
Install in Cursor:
- Open Cursor
- Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
- Type "install from vsix" and select "Extensions: Install from VSIX..."
- Browse to the downloaded remote-file-browser-latest.vsix file
- Select the file to install
Restart Cursor to activate the extension

For VSCode users, this extension is available in the marketplace, so you don't need manual installation unless you specifically want the latest development version.

Building and Installation

Installing from Source

Clone the repository:

git clone https://github.com/cartpauj/remote-file-browser.git
cd remote-file-browser

Install dependencies:
```
npm install
```

Build the extension:

# Development build (webpack bundling)
npm run compile

# Production build (minified)
npm run package

Install the extension:

Option A: Copy to Extensions Directory
- Copy the entire project folder to your extensions directory:
  - Windows: %USERPROFILE%\.vscode\extensions\ or %USERPROFILE%\.cursor\extensions\
  - macOS: ~/.vscode/extensions/ or ~/.cursor/extensions/
  - Linux: ~/.vscode/extensions/ or ~/.cursor/extensions/
- Restart VSCode/Cursor
Option B: Package and Install
- Install the packaging tool: npm install -g vsce
- Package the extension: vsce package
- Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
- Type "install from vsix"
- Select "Extensions: Install from VSIX..."
- Browse to your .vsix file

Development Workflow

Watch for changes (auto-compile with webpack):
```
npm run watch
```
Test in Extension Development Host:
- Press F5 in VSCode/Cursor
- Or use "Run Extension" in the Run and Debug panel

Manual builds:

# Development build
npm run compile

# Production build (minified)
npm run package

After making changes:
- Use "Developer: Reload Window" to reload the extension
- Or restart VSCode/Cursor completely

For technical details and development information, see PROJECT-SCOPE.md

Name		Name	Last commit message	Last commit date
Latest commit History 99 Commits
src		src
templates		templates
.gitignore		.gitignore
.vscodeignore		.vscodeignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
RELEASE.md		RELEASE.md
icon.png		icon.png
package-lock.json		package-lock.json
package.json		package.json
remote-file-browser-latest.vsix		remote-file-browser-latest.vsix
tsconfig.json		tsconfig.json
webpack.config.js		webpack.config.js

License

cartpauj/remote-file-browser

Folders and files

Latest commit

History

Repository files navigation