No Description

Dean Sheather 1b15b2be9b Merge pull request #125 from cdr/use-curl 1 month ago
.sail 5fad5953c4 Add flag to sync extensions back to local 4 months ago
ci 6319b9430a Add CI 3 months ago
.gitignore dbc0ff5e15 Add a --bind flag for local port (#82) 3 months ago
.travis.yml 326938c855 Add a sanity test 3 months ago
LICENSE 95d4a0df1c Add LICENSE 4 months ago 780633703d add remote OS support paragraph to README 1 month ago
demo.gif f779ba4cea Initial commit 4 months ago
go.mod 304ae28863 Use for argument/flag parsing 3 months ago
go.sum 304ae28863 Use for argument/flag parsing 3 months ago
main.go 1bc6ac0eab Merge branch 'master' into reuse-ssh-connection 1 month ago
settings.go dcd29f0390 Allow specifying alternate VS Code settings dirs 4 months ago
sshcode.go 1eaed4cacd replace wget with curl 1 month ago
sshcode_test.go 5ea05ebdfa Solves proxy issue, closes #74 when proxy is set at .profile 1 month ago


MIT license Discord Build Status

sshcode is a CLI to automatically install and run code-server over SSH.

It uploads your extensions and settings automatically, so you can seamlessly use remote servers as VS Code hosts.

If you have Chrome installed, it opens the browser in app mode. That means there's no keybind conflicts, address bar, or indication that you're coding within a browser. It feels just like native VS Code.



Have Chrome installed for the best experience.

Install with go:

go get -u

Or, grab a pre-built binary.

OS Support

We currently support:

  • Linux
  • MacOS
  • WSL

For the remote server, we currently only support Linux x86_64 (64-bit) servers with glibc. musl libc (which is most notably used by Alpine Linux) is currently not supported on the remote server: #122.


# Starts code-server on and opens in a new browser window.

You can specify a remote directory as the second argument:

sshcode "~/projects/sourcegraph"

Extensions & Settings Sync

By default, sshcode will rsync your local VS Code settings and extensions to the remote server every time you connect.

This operation may take a while on a slow connections, but will be fast on follow-up connections to the same server.

To disable this feature entirely, pass the --skipsync flag.

Custom settings directories

If you're using an alternate release of VS Code such as VS Code Insiders, you must specify your settings directories through the VSCODE_CONFIG_DIR and VSCODE_EXTENSIONS_DIR environment variables.

The following will make sshcode work with VS Code Insiders:


export VSCODE_CONFIG_DIR="$HOME/Library/Application Support/Code - Insiders/User"
export VSCODE_EXTENSIONS_DIR="$HOME/.vscode-insiders/extensions"


export VSCODE_CONFIG_DIR="$HOME/.config/Code - Insiders/User"
export VSCODE_EXTENSIONS_DIR="$HOME/.vscode-insiders/extensions"


By default, VS Code changes on the remote server won't be synced back when the connection closes. To synchronize back to local when the connection ends, pass the -b flag.