You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[Git Credential Manager Core](https://github.com/microsoft/Git-Credential-Manager-Core) (GCM Core) is a secure Git credential helper built on [.NET](https://dotnet.microsoft.com) that runs on Windows, macOS, and Linux.
7
+
[Git Credential Manager](https://github.com/GitCredentialManager/git-credential-manager) (GCM) is a secure Git credential helper built on [.NET](https://dotnet.microsoft.com) that runs on Windows, macOS, and Linux.
8
8
9
-
Compared to Git's [built-in credential helpers]((https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage)) (Windows: wincred, macOS: osxkeychain, Linux: gnome-keyring/libsecret) which provides single-factor authentication support working on any HTTP-enabled Git repository, GCM Core provides multi-factor authentication support for [Azure DevOps](https://dev.azure.com/), Azure DevOps Server (formerly Team Foundation Server), GitHub, and Bitbucket.
9
+
Compared to Git's [built-in credential helpers]((https://git-scm.com/book/en/v2/Git-Tools-Credential-Storage)) (Windows: wincred, macOS: osxkeychain, Linux: gnome-keyring/libsecret) which provides single-factor authentication support working on any HTTP-enabled Git repository, GCM provides multi-factor authentication support for [Azure DevOps](https://dev.azure.com/), Azure DevOps Server (formerly Team Foundation Server), GitHub, and Bitbucket.
10
10
11
-
Git Credential Manager Core (GCM Core) replaces the .NET Framework-based [Git Credential Manager for Windows](https://github.com/microsoft/Git-Credential-Manager-for-Windows) (GCM), and the Java-based [Git Credential Manager for Mac and Linux](https://github.com/microsoft/Git-Credential-Manager-for-Mac-and-Linux) (Java GCM), providing a consistent authentication experience across all platforms.
11
+
Git Credential Manager (GCM) replaces the .NET Framework-based [Git Credential Manager for Windows](https://github.com/microsoft/Git-Credential-Manager-for-Windows) (GCM), and the Java-based [Git Credential Manager for Mac and Linux](https://github.com/microsoft/Git-Credential-Manager-for-Mac-and-Linux) (Java GCM), providing a consistent authentication experience across all platforms.
12
12
13
13
## Current status
14
14
15
-
Git Credential Manager Core is currently available for Windows, macOS, and Linux. GCM only works with HTTP(S) remotes; you can still use Git with SSH:
15
+
Git Credential Manager is currently available for Windows, macOS, and Linux. GCM only works with HTTP(S) remotes; you can still use Git with SSH:
#### Git Credential Manager for Mac and Linux (Java-based GCM)
60
60
61
-
If you have an existing installation of the 'Java GCM' on macOS and you have installed this using Homebrew, this installation will be unlinked (`brew unlink git-credential-manager`) when GCM Core is installed.
61
+
If you have an existing installation of the 'Java GCM' on macOS and you have installed this using Homebrew, this installation will be unlinked (`brew unlink git-credential-manager`) when GCM is installed.
We also provide a [.pkg installer](https://github.com/microsoft/Git-Credential-Manager-Core/releases/latest) with each release. To install, double-click the installation package and follow the instructions presented.
75
+
We also provide a [.pkg installer](https://github.com/GitCredentialManager/git-credential-manager/releases/latest) with each release. To install, double-click the installation package and follow the instructions presented.
Download the latest [.deb package](https://github.com/microsoft/Git-Credential-Manager-Core/releases/latest), and run the following:
93
+
Download the latest [.deb package](https://github.com/GitCredentialManager/git-credential-manager/releases/latest), and run the following:
94
94
95
95
```shell
96
96
sudo dpkg -i <path-to-package>
@@ -103,30 +103,30 @@ Debian package using the above instructions instead.
103
103
104
104
#### Other distributions
105
105
106
-
Download the latest [tarball](https://github.com/microsoft/Git-Credential-Manager-Core/releases/latest), and run the following:
106
+
Download the latest [tarball](https://github.com/GitCredentialManager/git-credential-manager/releases/latest), and run the following:
107
107
108
108
```shell
109
109
tar -xvf <path-to-tarball> -C /usr/local/bin
110
110
git-credential-manager-core configure
111
111
```
112
112
113
-
**Note:** all Linux distributions [require additional configuration](https://aka.ms/gcmcore-credstores) to use GCM Core.
113
+
**Note:** all Linux distributions [require additional configuration](https://aka.ms/gcm/credstores) to use GCM.
114
114
115
115
---
116
116
117
117
### Windows
118
118
119
-
GCM Core is included with [Git for Windows](https://gitforwindows.org/), and the latest version is included in each new Git for Windows release. This is the preferred way to install GCM Core on Windows. During installation you will be asked to select a credential helper, with GCM Core being set as the default.
119
+
GCM is included with [Git for Windows](https://gitforwindows.org/), and the latest version is included in each new Git for Windows release. This is the preferred way to install GCM on Windows. During installation you will be asked to select a credential helper, with GCM being set as the default.
You can also download the [latest installer](https://github.com/microsoft/Git-Credential-Manager-Core/releases/latest) for Windows to install GCM Core standalone.
125
+
You can also download the [latest installer](https://github.com/GitCredentialManager/git-credential-manager/releases/latest) for Windows to install GCM standalone.
126
126
127
127
**:warning: Important :warning:**
128
128
129
-
Installing GCM Core as a standalone package on Windows will forcibly override the version of GCM Core that is bundled with Git for Windows, **even if the version bundled with Git for Windows is a later version**.
129
+
Installing GCM as a standalone package on Windows will forcibly override the version of GCM that is bundled with Git for Windows, **even if the version bundled with Git for Windows is a later version**.
130
130
131
131
There are two flavors of standalone installation on Windows:
132
132
@@ -142,23 +142,23 @@ To install, double-click the desired installation package and follow the instruc
142
142
143
143
#### Uninstall (Windows 10)
144
144
145
-
To uninstall, open the Settings app and navigate to the Apps section. Select "Git Credential Manager Core" and click "Uninstall".
145
+
To uninstall, open the Settings app and navigate to the Apps section. Select "Git Credential Manager" and click "Uninstall".
146
146
147
147
#### Uninstall (Windows 7-8.1)
148
148
149
-
To uninstall, open Control Panel and navigate to the Programs and Features screen. Select "Git Credential Manager Core" and click "Remove".
149
+
To uninstall, open Control Panel and navigate to the Programs and Features screen. Select "Git Credential Manager" and click "Remove".
150
150
151
151
#### Windows Subsystem for Linux (WSL)
152
152
153
-
Git Credential Manager Core can be used with the [Windows Subsystem for Linux
153
+
Git Credential Manager can be used with the [Windows Subsystem for Linux
154
154
(WSL)](https://aka.ms/wsl) to enable secure authentication of your remote Git
155
155
repositories from inside of WSL.
156
156
157
-
[Please see the GCM Core on WSL docs](docs/wsl.md) for more information.
157
+
[Please see the GCM on WSL docs](docs/wsl.md) for more information.
158
158
159
159
## Supported Git versions
160
160
161
-
Git Credential Manager Core tries to be compatible with the broadest set of Git
161
+
Git Credential Manager tries to be compatible with the broadest set of Git
162
162
versions (within reason). However there are some know problematic releases of
163
163
Git that are not compatible.
164
164
@@ -174,17 +174,17 @@ Git that are not compatible.
174
174
175
175
## How to use
176
176
177
-
Once it's installed and configured, Git Credential Manager Core is called implicitly by Git.
178
-
You don't have to do anything special, and GCM Core isn't intended to be called directly by the user.
177
+
Once it's installed and configured, Git Credential Manager is called implicitly by Git.
178
+
You don't have to do anything special, and GCM isn't intended to be called directly by the user.
179
179
For example, when pushing (`git push`) to [Azure DevOps](https://dev.azure.com), [Bitbucket](https://bitbucket.org), or [GitHub](https://github.com), a window will automatically open and walk you through the sign-in process.
180
180
(This process will look slightly different for each Git host, and even in some cases, whether you've connected to an on-premises or cloud-hosted Git host.)
181
-
Later Git commands in the same repository will re-use existing credentials or tokens that GCM Core has stored for as long as they're valid.
181
+
Later Git commands in the same repository will re-use existing credentials or tokens that GCM has stored for as long as they're valid.
182
182
183
183
Read full command line usage [here](docs/usage.md).
184
184
185
185
### Configuring a proxy
186
186
187
-
See detailed information [here](https://aka.ms/gcmcore-httpproxy).
187
+
See detailed information [here](https://aka.ms/gcm/httpproxy).
Git Credential Manager Core (GCM Core) is built to be Git host and platform/OS
39
+
Git Credential Manager (GCM) is built to be Git host and platform/OS
40
40
agonstic. Most of the shared logic (command execution, the abstract platform
41
41
subsystems, etc) can be found in the `Core` class
42
42
library (C#). The library targets .NET Standard as well as .NET Framework.
@@ -52,10 +52,10 @@ library (C#). The library targets .NET Standard as well as .NET Framework.
52
52
> our own browser pop-up handling code on .NET meaning both Windows and
53
53
> Mac. We haven't yet gotten around to exploring this.
54
54
>
55
-
> See [this](https://github.com/microsoft/Git-Credential-Manager-Core/issues/113)
55
+
> See [this](https://github.com/GitCredentialManager/git-credential-manager/issues/113)
56
56
> issue for more information.
57
57
58
-
The entry-point for GCM Core can be found in the `Git-Credential-Manager`
58
+
The entry-point for GCM can be found in the `Git-Credential-Manager`
59
59
project, a console application that targets both .NET and .NET Framework.
60
60
This project emits the `git-credential-manager-core(.exe)` executable, and
61
61
contains very little code - registration of all supported host providers and
@@ -81,21 +81,21 @@ helpers on Windows.
81
81
### Cross-platform UI
82
82
83
83
We hope to be able to migrate the WPF/Windows only helpers to [Avalonia](https://avaloniaui.net/)
84
-
in order to gain cross-platform graphical user interface support. See [this](https://github.com/microsoft/Git-Credential-Manager-Core/issues/136)
84
+
in order to gain cross-platform graphical user interface support. See [this](https://github.com/GitCredentialManager/git-credential-manager/issues/136)
85
85
issue for up-to-date progress on this effort.
86
86
87
87
### Microsoft authentication
88
88
89
89
For authentication using Microsoft Accounts or Azure Active Directory, things
90
90
are a little different. The `MicrosoftAuthentication` component is present in
91
-
the core `Core` assembly, rather than bundled with a
91
+
the `Core` core assembly, rather than bundled with a
92
92
specific host provider. This was done to allow any service that may wish to in
93
93
the future integrate with Microsoft Accounts or Azure Active Directory can make
94
94
use of this reusable authentication component.
95
95
96
96
## Asynchronous programming
97
97
98
-
GCM Core makes use of the `async`/`await` model of .NET and C# in almost all
98
+
GCM makes use of the `async`/`await` model of .NET and C# in almost all
99
99
parts of the codebase where appropriate as usually requests end up going to the
100
100
network at some point.
101
101
@@ -142,10 +142,10 @@ network at some point.
142
142
+---------------+
143
143
```
144
144
145
-
Git Credential Manager Core maintains a set of known commands including
145
+
Git Credential Manager maintains a set of known commands including
146
146
`Get|Store|EraseCommand`, as well as commands for install and help/usage.
147
147
148
-
GCM Core also maintains a set of known, registered host providers that implement
148
+
GCM also maintains a set of known, registered host providers that implement
149
149
the `IHostProvider` interface. Providers register themselves by adding an
150
150
instance of the provider to the `Application` object via the `RegisterProvider`
0 commit comments