Remote - Github
Why Remote - Github
How to browse github repository in VSCode?
Usually we need to
That's really a waste of time and resource, especially when network is slow and the repo contains so many git big binary objects.
Remote - Github made opening a remote github repo as easy as open a local folder, you don't have to download anything to your local file system.
How to use Remote - Github
Using Remote - Github cannot be easier, all you need is to sign in, and browse.
To authenticate yourself, you have two choice: Password Authetication and Personal Access Token.
In the second popup window, type in your password or personal access token:
After login success, you would see a cute github icon with your username on the right bottom bar:
Provide your own keystore path
If you want higher security level, you could provide your own path of file which contains your authentication string in <username>:<password> or <username>:<personal access token>. For example:
And paste absolute path to
Setup Github To Workspace
Just type in the url of your github repository, for example,
you can navigate through this repository just like navigate your local folder,
Let's try to navigate through
Of course you can open the whole repository, all you need is select
Note that the folder resides in memory, not stored persistently, if you close the window, all loaded files are gone.
Many times, a git repository contains many independent tutorial samples, typically
Instead of cloning the whole big git repository, you could just open one subfolder:
Open one file is also ok. You can try it out.
Enable VS Code Full Feature Set By Providing Mount Point
VS Code supports Intellisense, Code Navigation, File Searching, etc. Browing code would be much easier with these amazing features, but people find they cannot do this with files loaded by Remote - Github.
It is because Remote - Github stores them to memory, namely, virtual file system first, so the vscode could not analyze it, neither do other tools like
Remote - Github now gives you a choice to enable all these features by writing loaded files to your local fs. It's really simple, all you need is provide a "mount point" (just an absolute path to store the whole github folder):
Once the mount point is provided, all loaded file would be written to a newly created
After that, you could find anything in your local github folder, and you can compile it, modify and save it, and run it.
In 0.1, if you want to open
With Repository Searching, all you have to do it provide a single keyword like "vscode", and Remote-Github would provide you several searching results for you to pick:
This would not break the old behavior, if you provide full link, everything works like in 0.1.
The namespaces of file are dealt with gracefully, open mutiple repos would not conflict with each other:
It seems we mount the whole Github as our local disk partition!
Save As Local Files
Although the repo resides in memory, but you could download it to your local file system:
Just right click any folder or files, and click download.
Open Different Snapshot
Remote - Github seems ignore the "git things": branches, commits, tags...
But it's not.
You can specify which branch, or which tag you want to browse, and the syntax is pretty straghtforward:
If you want to open
If you want to open
Create Remote Github Repository In VS Code
In order to set up a remote repo, usually we need to open browser and create a repo in github manually, and then push the local repo to it.
With Remote - Github, you can create remote github repo right in VS Code and sync with your local repo automatically.
select repo type, public or private:
Wait a sec, the repo would be created:
Once repo is created, Remote - Github would open a new terminal, and run several commands to set up your local repo to sync with your remote repo:
Open big repository like