v3.2.1 • Stable Release

Install .git CLI

Get the official .git command-line interface running in seconds. Cross-platform, lightweight, and built for speed.

cURL (Universal)

curl | sh

Homebrew

brew install

npm

npm i -g

pip

pip install

Prerequisites

Ensure Xcode Command Line Tools are installed:

$ xcode-select --install

Install via Homebrew (Recommended)

Add the official tap and install:

$ brew tap .git/official\nbrew install .git/cli

Verify Installation

Check the installed version:

$ .git --version
.git v3.2.1 (macOS/arm64)

System Requirements

Debian/Ubuntu 20.04+ or RHEL/CentOS 8+. Ensure curl and gpg are installed.

Add Repository & Install

Import the signing key and add the apt repository:

$ curl -fsSL https://repo.git.dev/key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/git-archive-keyring.gpg\necho "deb [signed-by=/usr/share/keyrings/git-archive-keyring.gpg] https://repo.git.dev/apt stable main" | sudo tee /etc/apt/sources.list.d/git.list\nsudo apt update && sudo apt install .git-cli

Verify Installation

Run the version check to confirm successful installation:

$ .git --version
.git v3.2.1 (Linux/x86_64)

Prerequisites

Windows 10/11 with WSL2 or Git Bash recommended. Administrator privileges required for system-wide install.

Install via Winget or Scoop

Use your preferred package manager:

C:\> winget install .git.cli

# OR using Scoop:
$ scoop install git-cli

Verify Installation

Open a new terminal and verify the binary path:

C:\> .git --version
.git v3.2.1 (Windows/10/amd64)

Post-Installation Setup

Once installed, authenticate and initialize your first workspace:

$ .git auth login\n✓ Authenticated as dev@yourdomain.com\n\n$ mkdir my-project && cd my-project\n\n$ .git init --template modern\n✓ Workspace initialized\n✓ Default branch: main\n✓ Remote configured

Troubleshooting

Command not found

If `.git` isn't recognized, ensure your PATH includes the installation directory. Run `hash -r` (bash) or `doskey /reinstall` (cmd) to refresh.

Permission Denied

On Linux/macOS, run with `sudo` for system-wide installs, or use `--user` flag for local installs: `.git install --user`

Node Version Error

npm installations require Node.js 18+. Verify with `node -v` and update if necessary before running `npm i -g @.git/cli`.

SSL/TLS Verify Failed

Corporate proxies may block package managers. Set `NODE_TLS_REJECT_UNAUTHORIZED=0` temporarily or configure your proxy credentials.