RemoteHub is a proof-of-concept extension that allows for opening a remote GitHub repository as a workspace. Experimental code search and language services (go to definition, go to implementation, hovers, find references, etc) are provided by Sourcegraph and will only work on public repositories that are enabled and supported by them.
NOTE: This extension is in the very early stages and is likely to have lots of bugs and only work in certain cases, so please keep that in mind. Also please file GitHub issues for any questions, features, or issues. Thanks!
- Adds an Open GitHub Repository... command (
remotehub.openRepository) which allows you to search for a remote GitHub repository to open in the current window
- Adds an Open GitHub Repository in New Window... command (
remotehub.openRepositoryInNewWindow) which allows you to search for a remote GitHub repository to open in a new window
- Adds an Add GitHub Repository to Workspace... command (
remotehub.addRepository) which allows you to search for a remote GitHub repository to add to the current workspace
- Adds a Clone GitHub Repository... command (
remotehub.cloneRepository) which allows you to search for a remote GitHub repository to clone
- Adds a Clone Current Remote Repository... command (
remotehub.cloneCurrentRepository) which allows you to clone an opened remote GitHub repository
- Adds an Open Current Remote Repository on GitHub... command (
remotehub.openCurrentRepositoryOnGitHub) which allows you to open the current repository on GitHub
- Adds support for a
remotehub:// uri scheme, e.g.
remotehub://github.com/eamodio/vscode-remotehub which can be saved into a workspace
Generate a GitHub personal access token
If you already have a token saved in the
github.accessToken setting, you can skip this section as RemoteHub can use that token
RemoteHub requires a personal access token to authenticate to GitHub’s REST and GraphQL API. Follow the steps in the GitHub guide, enabling the following scopes:
Copy the generated access token to your clipboard and paste it into the input box or into your
settings.json as follows:
Enabling File and Text Search
RemoteHub requires the use of proposed (read: experimental) APIs to provide both file and text search within VS Code.
To enable search:
"remotehub.insiders": true in your settings
- Restart and run VS Code with the the following command line switch:
|Specifies the GitHub personal access token to use for authentication with the GitHub GraphQL API
|Specifies whether to enable experimental features
|Specifies the remote service to use for repository search
github - use GitHub search (only filename search)
sourcegraph - use Sourcegraph search
|Specifies how much (if any) output will be sent to the RemoteHub output channel
A big thanks to the people that have contributed to this project:
And of course the awesome vscode and sourcegraph teams!