Working with GitHub in VS Code https://code.visualstudio.

com/docs/sourcecontrol/github

🚀 Get GitHub Copilot Free (vscode://github.copilot-chat?referrer=vscode-updatebanner) in VS

Code!
×

TOPICS Collaborate on GitHub

IN THIS ARTICLE Getting started with GitHub Pull Requests and Issues

(https://vscode.dev/github/microsoft/vscode-docs/blob/main/docs/sourcecontrol/github.md)

Working with GitHub in VS Code

GitHub (https://github.com) is a cloud-based service for storing and sharing source code. Using GitHub
with Visual Studio Code lets you share your source code and collaborate with others right within your
editor. There are many ways to interact with GitHub, for example, via their website at https://github.com
(https://github.com) or the Git (https://git-scm.com) command-line interface (CLI), but in VS Code, the
rich GitHub integration is provided by the GitHub Pull Requests and Issues (https://
marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github) extension.

Install the GitHub Pull Requests and Issues extension (vscode:extension/

GitHub.vscode-pull-request-github)

To get started with the GitHub in VS Code, you'll need to install Git (https://git-scm.com/download), create
a GitHub account (https://docs.github.com/get-started/signing-up-for-github/signing-up-for-a-new-
github-account) and install the GitHub Pull Requests and Issues (https://marketplace.visualstudio.com/
items?itemName=GitHub.vscode-pull-request-github) extension. In this topic, we'll demonstrate how you
can use some of your favorite parts of GitHub without leaving VS Code.

If you're new to source control or want to learn more about VS Code's basic Git support, you can start with
the Source Control (/docs/sourcecontrol/overview) topic.

Getting started with GitHub Pull Requests and Issues

Once you've installed the GitHub Pull Requests and Issues (https://marketplace.visualstudio.com/items?
itemName=GitHub.vscode-pull-request-github) extension, you'll need to sign in. Follow the prompts to
authenticate with GitHub in the browser and return to VS Code.

1 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

If you are not redirected to VS Code, you can add your authorization token manually. In the browser
window, you will receive your authorization token. Copy the token, and switch back to VS Code. Select
Signing in to github.com... in the Status bar, paste the token, and hit Enter .

Setting up a repository

Cloning a repository
You can search for and clone a repository from GitHub using the Git: Clone command in the Command
Palette ( ⇧⌘P ) or by using the Clone Repository button in the Source Control view (available when you
have no folder open).

2 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

From the GitHub repository dropdown you can filter and pick the repository you want to clone locally.

Authenticating with an existing repository

Enabling authentication through GitHub happens when you run any Git action in VS Code that requires
GitHub authentication, such as pushing to a repository that you're a member of or cloning a private
repository. You don't need to have any special extensions installed for authentication; it is built into VS
Code so that you can efficiently manage your repository.

When you do something that requires GitHub authentication, you'll see a prompt to sign in:

Follow the steps to sign into GitHub and return to VS Code. Signing in with a personal access token (PAT)

3 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

is only supported with GitHub Enterprise Server. If you're using GitHub Enterprise Server and want to use
a PAT, then you can hit "cancel" on the sign in prompts until you are prompted for a PAT.

Note that there are several ways to authenticate to GitHub, including using your username and password
with two-factor authentication (2FA), a personal access token, or an SSH key. See About authentication to
GitHub (https://docs.github.com/github/authenticating-to-github/about-authentication-to-github) for more
information and details about each option.

Note: If you'd like to work on a repository without cloning the contents to your local machine, you can
install the GitHub Repositories (https://marketplace.visualstudio.com/items?
itemName=github.remotehub) extension to browse and edit directly on GitHub. You can learn more
below in the GitHub Repositories extension (/docs/sourcecontrol/github#_github-repositories-
extension) section.

Editor integration

Hovers
When you have a repository open and a user is @-mentioned, you can hover over that username and see a
GitHub-style hover.

4 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

There is a similar hover for #-mentioned issue numbers, full GitHub issue URLs, and repository specified
issues.

Suggestions
User suggestions are triggered by the "@" character and issue suggestions are triggered by the "#"
character. Suggestions are available in the editor and in the Source Control view's input box.

The issues that appear in the suggestion can be configured with the GitHub Issues: Queries (
! (vscode://settings/githubIssues.queries)githubIssues.queries ) setting (/docs/editor/settings). The
queries use the GitHub search syntax (https://docs.github.com/search-github/getting-started-with-
searching-on-github/understanding-the-search-syntax).

You can also configure which files show these suggestions using the settings GitHub Issues: Ignore
Completion Trigger (
! (vscode://settings/githubIssues.ignoreCompletionTrigger)githubIssues.ignoreCompletionTrigger ) and
GitHub Issues: Ignore User Completion Trigger (
! (vscode://settings/
githubIssues.ignoreUserCompletionTrigger)githubIssues.ignoreUserCompletionTrigger
). These settings take an array of language identifiers (/docs/languages/identifiers) to specify the file

5 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

types.

Copy
// Languages that the '#' character should not be used to trigger issue completion s
uggestions.
"githubIssues.ignoreCompletionTrigger": [
"python"
]

Pull requests

From the Pull Requests view you can view, manage, and create pull requests.

The queries used to display pull requests can be configured with the GitHub Pull Requests: Queries (
! (vscode://settings/githubPullRequests.queries)githubPullRequests.queries ) setting and use the GitHub
search syntax (https://docs.github.com/search-github/getting-started-with-searching-on-github/
understanding-the-search-syntax).

"githubPullRequests.queries": [ Copy
{
"label": "Assigned To Me",
"query": "is:open assignee:${user}"
},

Creating pull requests

6 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

Once you have committed changes to your fork or branch, you can use the GitHub Pull Requests: Create
Pull Request command or the Create Pull Request button in the Pull Requests view to create a pull
request.

A new Create view will be displayed where you can select the base repository and base branch you'd like
your pull request to target as well as fill in the title and description. If your repository has a pull request
template, this will automatically be used for the description.

Use the buttons in the action bar at the top to add Assignees, Reviewers, Labels and a Milestone.

7 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

The Create button menu allows you to select alternative create options, such as Create Draft or enable an
Auto-Merge method.

Once you select Create, if you have not already pushed your branch to a GitHub remote, the extension will
ask if you'd like to publish the branch and provides a dropdown to select the specific remote.

The Create Pull Request view now enters Review Mode, where you can review the details of the PR, add
comments, and merge the PR once it's ready. After the PR is merged, you'll have the option to delete both
the remote and local branch.

Tip
Use GitHub Copilot to generate a PR title and description, based on the commits that are included in
the PR. Select the sparkle icon next to the PR title field to generate a PR title and description.

Reviewing

8 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

Pull requests can be reviewed from the Pull Requests view. You can assign reviewers and labels, add
comments, approve, close, and merge all from the pull request Description.

From the Description page, you can also easily checkout the pull request locally using the Checkout
button. This will switch VS Code to open the fork and branch of the pull request (visible in the Status bar)
in Review Mode and add a new Changes in Pull Request view from which you can view diffs of the current
changes as well as all commits and the changes within these commits. Files that have been commented on
are decorated with a diamond icon. To view the file on disk, you can use the Open File inline action.

9 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

The diff editors from this view use the local file, so file navigation, IntelliSense, and editing work as normal.
You can add comments within the editor on these diffs. Both adding single comments and creating a
whole review is supported.

When you are done reviewing the pull request changes you can merge the PR or select Exit Review Mode
to go back to the previous branch you were working on.

Tip
You can also let Copilot perform a code review of the PR (https://docs.github.com/en/copilot/using-
github-copilot/code-review/using-copilot-code-review?tool=vscode) before you create it. Select the
Copilot Code Review button in the GitHub Pull Request view.

Issues

Creating issues
Issues can be created from the + button in the Issues view and by using the GitHub Issues: Create Issue
from Selection and GitHub Issues: Create Issue from Clipboard commands. They can also be created
using a Code Action for "TODO" comments. When creating issues, you can take the default description or
select the Edit Description pencil icon in the upper right to bring up an editor for the issue body.

You can configure the trigger for the Code Action using the GitHub Issues: Create Issue Triggers (
! (vscode://settings/githubIssues.createIssueTriggers)githubIssues.createIssueTriggers ) setting.

The default issue triggers are:

10 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

"githubIssues.createIssueTriggers": [ Copy
"TODO",
"todo",
"BUG",
"FIXME",
"ISSUE",
"HACK"
]

Working on issues
From the Issues view, you can see your issues and work on them.

By default, when you start working on an issue (Start Working on Issue context menu item), a branch will
be created for you, as shown in the Status bar in the image below.

11 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

The Status bar also shows the active issue and if you select that item, a list of issue actions are available
such as opening the issue on the GitHub website or creating a pull request.

12 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

You can configure the name of the branch using the GitHub Issues: Issue Branch Title (
! (vscode://settings/githubIssues.issueBranchTitle)githubIssues.issueBranchTitle ) setting. If your
workflow doesn't involve creating a branch, or if you want to be prompted to enter a branch name every
time, you can skip that step by turning off the GitHub Issues: Use Branch For Issues (
! (vscode://settings/githubIssues.useBranchForIssues)githubIssues.useBranchForIssues ) setting.

Once you are done working on the issue and want to commit a change, the commit message input box in
the Source Control view will be populated with a message, which can be configured with GitHub Issues:
Working Issue Format SCM (
! (vscode://settings/githubIssues.workingIssueFormatScm)githubIssues.workingIssueFormatScm ).

GitHub Repositories extension

The GitHub Repositories (https://marketplace.visualstudio.com/items?itemName=github.remotehub)

extension lets you quickly browse, search, edit, and commit to any remote GitHub repository directly from
within Visual Studio Code, without needing to clone the repository locally. This can be fast and convenient
for many scenarios, where you just need to review source code or make a small change to a file or asset.

Opening a repository
Once you have installed the GitHub Repositories extension, you can open a repository with the GitHub
Repositories: Open Repository... command from the Command Palette ( ⇧⌘P ) or by clicking the Remote
indicator in the lower left of the Status bar.

13 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

When you run the Open Repository command, you then choose whether to open a repository from
GitHub, open a Pull Request from GitHub, or reopen a repository that you had previously connected to.

If you haven't logged into GitHub from VS Code before, you'll be prompted to authenticate with your
GitHub account.

You can provide the repository URL directly or search GitHub for the repository you want by typing in the
text box.

Once you have selected a repository or Pull Request, the VS Code window will reload and you will see the
repository contents in the File Explorer. You can then open files (with full syntax highlighting and bracket
matching), make edits, and commit changes, just like you would working on a local clone of a repository.

One difference from working with a local repository is that when you commit a change with the GitHub
Repository extension, the changes are pushed directly to the remote repository, similar to if you were
working in the GitHub web interface.

Another feature of the GitHub Repositories extension is that every time you open a repository or branch,
you get the up-to-date sources available from GitHub. You don't need to remember to pull to refresh as
you would with a local repository.

The GitHub Repositories extension supports viewing and even committing LFS-tracked files without
needing to install Git LFS (https://git-lfs.github.com) (Large File System) locally. Add the file types you
want tracked with LFS to a .gitattributes file (https://git-lfs.com), then commit your changes directly
to GitHub using the Source Control view.

Switching branches
You can easily switch between branches by clicking on the branch indicator in the Status bar. One great
feature of the GitHub Repositories extension is that you can switch branches without needing to stash
uncommitted changes. The extension remembers your changes and reapplies them when you switch
branches.

14 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

Remote Explorer
You can quickly reopen remote repositories with the Remote Explorer available on the Activity bar. This
view shows you the previously opened repositories and branches.

Create Pull Requests

If your workflow uses Pull Requests, rather than direct commits to a repository, you can create a new PR
from the Source Control view. You'll be prompted to provide a title and create a new branch.

15 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

Once you have created a Pull Request, you can use the GitHub Pull Request and Issues (https://
marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github) extension to review,
edit, and merge your PR as described earlier (/docs/sourcecontrol/github#_pull-requests) in this topic.

Virtual file system

Without a repository's files on your local machine, the GitHub Repositories extension creates a virtual file
system in memory so you can view file contents and make edits. Using a virtual file system means that
some operations and extensions which assume local files are not enabled or have limited functionality.
Features such as tasks, debugging, and integrated terminals are not enabled and you can learn about the
level of support for the virtual file system via the features are not available link in the Remote indicator
hover.

Extension authors can learn more about running in a virtual file system and workspace in the Virtual
Workspaces extension author's guide (https://github.com/microsoft/vscode/wiki/Virtual-Workspaces).

Continue Working On...

Sometimes you'll want to switch to working on a repository in a development environment with support for
a local file system and full language and development tooling. The GitHub Repositories extension makes it
easy for you to:

• Create a GitHub codespace (if you have the GitHub Codespaces extension (https://
marketplace.visualstudio.com/items?itemName=GitHub.codespaces)).
• Clone the repository locally.
• Clone the repository into a Docker container (if you have Docker (https://docker.com/) and the
Microsoft Docker extension (https://marketplace.visualstudio.com/items?itemName=ms-
azuretools.vscode-docker) installed).

To switch development environments, use the Continue Working On... command, available from the
Command Palette ( ⇧⌘P ) or by clicking on the Remote indicator in the Status bar.

16 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

If you are using the browser-based editor (/docs/remote/codespaces#_browserbased-editor), the

"Continue Working On..." command has the options to open the repository locally or within a cloud-
hosted environment in GitHub Codespaces (https://github.com/features/codespaces).

The first time that you use Continue Working On with uncommitted changes, you will have the option to
bring your edits to your selected development environment using Cloud Changes, which stores your
pending changes on the same VS Code service used for Settings Sync.

These changes are deleted from our service once they are applied to your target development
environment. If you choose to continue without your uncommitted changes, you can always change this
preference later by configuring the setting "workbench.cloudChanges.continueOn": "prompt" .

In the event that your pending changes are not automatically applied to your target development
environment, you can view, manage, and delete your stored changes using the Cloud Changes: Show
Cloud Changes command.

Next steps

• Learn more about Copilot VS Code (/docs/copilot/overview) - Learn about Copilot in VS Code.

17 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

Was this documentation helpful?

Yes No

02/06/2025

Subscribe(/feed.xml) Ask questions(https://stackoverflow.com/questions/tagged/vscode)

Follow @code(https://go.microsoft.com/fwlink/?LinkID=533687)

Request features(https://go.microsoft.com/fwlink/?LinkID=533482)

Report issues(https://www.github.com/Microsoft/vscode/issues)

Watch videos(https://www.youtube.com/channel/UCs5Y5_7XK8HLDX0SLNwkd3w)

18 sur 19 19/02/2025 20:32

Working with GitHub in VS Code https://code.visualstudio.com/docs/sourcecontrol/github

(https://
www.microsoft.com)

(https://go.microsoft.com/fwlink/?LinkID=533687)
(https://github.com/microsoft/vscode) (https://www.youtube.com/@code)

Support (https://support.serviceshub.microsoft.com/supportforbusiness/create?sapId=d66407ed-3967-
b000-4cfb-2c318cad363d)
Privacy (https://go.microsoft.com/fwlink/?LinkId=521839)
Terms of Use (https://www.microsoft.com/legal/terms-of-use) License (/License)

19 sur 19 19/02/2025 20:32