Install the .git CLI

The official command-line interface for managing projects, deployments, and team workflows. Install it once, deploy anywhere.

Homebrew (Recommended)

Terminal

# Install via Homebrew
brew install .git-cli

# Verify installation
.git --version

Manual Install

Terminal

# Download and install binary
curl -fsSL https://git.dev/install.sh | sh -s -- --arch amd64

# For Apple Silicon (M1/M2/M3)
curl -fsSL https://git.dev/install.sh | sh -s -- --arch arm64

WinGet / Scoop (Recommended)

PowerShell

# Using WinGet
winget install .git-cli

# Or using Scoop
scoop install .git-cli

# Verify
.git --version

Manual Install

PowerShell

# Download latest release
Invoke-WebRequest -Uri https://git.dev/releases/latest/win-x64.exe -OutFile .git.exe
Move-Item .git.exe $env:USERPROFILE\.git\bin\.git.exe

# Add to PATH (if not automatically detected)
$env:PATH += ";$env:USERPROFILE\.git\bin"

# Verify
.git --version

Universal Installer

Terminal

# Recommended for most distributions
curl -fsSL https://git.dev/install.sh | sh

# Verify
.git --version

Package Managers

Terminal

# Debian/Ubuntu
sudo apt update && sudo apt install .git-cli

# RHEL/CentOS/Fedora
sudo dnf install .git-cli

# Arch Linux
sudo pacman -S .git-cli

# Snap
sudo snap install .git-cli --classic

Install via Node.js

Terminal

# Requires Node.js 18+ or pnpm
npm i -g @gitdev/cli

# Verify
.git --version

Docker / Containerized

Terminal

# Run CLI in a container without installation
docker run --rm -it ghcr.io/gitdev/cli:latest --version

# Mount project and run commands
docker run --rm -v $(pwd):/app -w /app ghcr.io/gitdev/cli:latest init

Verify Installation

After installation, confirm the CLI is working correctly:

Terminal

.git --version
.git CLI v2.4.1 (stable)
✓ Platform: darwin/arm64
✓ Node runtime: linked
✓ Ready to deploy.

🔐 Authentication

Run .git auth to log in with your GitHub, GitLab, or SSO credentials. Tokens are stored securely in your OS keychain.

Quick Start

Initialize your first project and deploy to production in under a minute:

Terminal

# 1. Initialize project
.git init my-app

# 2. Connect repository (auto-detects git remote)
.git link --repo github/my-org/my-app

# 3. Preview build
.git preview
→ Preview URL: https://my-app-abc123.git.dev

# 4. Deploy to production
.git deploy --prod
✓ Deployed in 2.1s • HTTPS enabled • Edge cached

System Requirements

macOS

macOS 11.0+ (Big Sur) or later. x64 & Apple Silicon supported.

Windows

Windows 10+ (Build 1809+). PowerShell 5.1+ or WSL2 recommended.

Linux

glibc 2.17+, kernel 3.10+. Most modern distros supported out of the box.

Network

Outbound HTTPS access to git.dev and *.git.dev.

Troubleshooting

"command not found" — Ensure ~/.git/bin or your package manager's bin directory is in your $PATH. Run echo $PATH to verify.
"permission denied" — Run chmod +x ~/.git/bin/.git or use sudo for system-wide installs.
"SSL handshake failed" — Update your system CA certificates or configure GIT_PROXY if behind a corporate firewall.
Stuck on "resolving host" — Ensure api.git.dev resolves via DNS. Try ping api.git.dev or check proxy settings.

🛟 Need help?

Run .git doctor to automatically diagnose environment issues, or visit our support portal.