vscode-github README

This vscode extension integrates with GitHub.

Note: I recommend to use GitHub Pull Requests instead of this, because most usecases are supported and there is a team at Microsoft/GitHub supporting development

Features

Currently it is possible to do the following:

Checkout one of the open pull requests
Open github page for the current project in your default browser
Browse one of the open pull requests in your default browser
Browse the pull requests of your current branch
Display pull request and current status (e.g. mergeable, travis build done, ...) in the StatusBar (if enabled)
Create a new pull request based on the current branch and the last commit The current branch will be requested to merge into master and the pull request title is the commit message summary, or a custom message if configured that way.
Create a pull request in forked repositories
Allow to select a branch to create a pull request for
Merge current pull request with either of 'merge', 'squash' or 'rebase' method.
Configure default branch, merge method and refresh interval.
Allow to manage assignees for pull requests
- Assign or unassign a user (currently only one)
Allow to create and cancel pull request reviews
Support for GitHub Enterprise (on-premise installations)
Browse open issues
Browse the current open file (including current cursor position)
Configure the statusbar behaviour by setting the github.statusBarCommand configuration value.
Specify a GitLab private access token and connect to a GitLab server
Support multi folder setup

Setup Personal Access Token

To use this extension one needs to create a new GitHub Personal Access Token and registers it in the extension. The 'GitHub: Set Personal Access Token' should be executed for that. To execute the 'GitHub: Set Personal Access Token' type Ctrl+Shift+p in VSCode to open the command palette and type 'GitHub: Set Personal Access Token'. You will then be prompted to enter the token generated from GitHub.

Additionally, by default this extension assumes your remote for a checked out repo is named "origin". If you wish to use a remote with a different name, you can control this by the github.remoteName setting.

There are additional settings for this extension as well, enter github. in the User Settings pane of VS Code to see them all.

Usage

Create a new pull request

Create a new local branch from the commit you wanted to start developing with
Do you code changes
Commit your changes
Push your changes to your remote
Then execute Create pull request from current branch in current repository (quick)
In the status bar you can then see the status of your created pull request and if you'd like to open it

Create a new pull request from a forked repository

Fork a repository and clone it afterwards
Create a new local branch from the commit you wanted to start developing with
Do you code changes
Commit your changes
Push your changes to your remote
Then execute Create pull request...
Select the upstream repository you want to create the pull requests for Note: The status bar will not reflect the pull request status in this case

Checkout pull request

Execute Checkout open pull request...
Select a pull request from the list
The pull request is checked out and your working copy switches to that branch

Browser pull request

Execute Browse open pull request...
Select a pull request from the list
Your default browser opens the pull request on github

Merge pull request

Execute Merge pull request (current branch)...
Select your merge strategy from the shown list (merge, squash, rebase)
The pull request associated with your current branch is then merged

Telemetry data (extension usage)

This extension collects telemetry data to track and improve usage. The collection of data could be disabled as described here https://code.visualstudio.com/docs/supporting/faq#_how-to-disable-telemetry-reporting.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Markus Wolf} 💻	_{Ross Valler} 💻	_{Josh Eveleth} 💻	_sasial 💻	_timhaintz 📖	_{Adam Parkin} 📖	_{Andreas Holley} 💻
_Stanislas 📖	_{Corentin Girard} 💻	_{Mykola Morhun} 💻	_{Nicholas Mata} 💻	_{Tatsuyuki Ishi} 💻	_{Vincent van der Weele} 💻	_ivanmilov 💻
_Kyle 📖	_{Li Huanshuai} 💻	_{Shaikat Haque} 💻