Installing the CLI
The gitctl command-line interface is the primary tool for managing your .git deployments, environments, and team workflows. Install it in seconds using your preferred package manager.
Quick Install
# Using Homebrew brew install .git/tap/gitctl # Verify installation gitctl --version
Note: Homebrew is the recommended method for macOS. Ensure Xcode Command Line Tools are installed via xcode-select --install.
# Install via official script curl -fsSL https://git.dev/install.sh | sh # Verify installation gitctl --version
⚠️ Manual Installation
If your system blocks remote script execution, download the binary manually from our releases page and extract it to ~/bin or /usr/local/bin.
# Using winget winget install .git.gitctl # Or using Scoop scoop install gitctl # Verify installation gitctl --version
# Using npm npm install -g @.git/cli # Or using yarn yarn global add @.git/cli # Verify installation gitctl --version
Verify Installation
After installing, run the following command to ensure the CLI is correctly configured and connected to your system:
$ gitctl doctor ✓ CLI Version: 2.4.0 ✓ Node.js: v20.11.0 (supported) ✓ Platform: darwin/arm64 ✓ Authentication: Ready (gitctl auth login) All checks passed. You're ready to deploy!
Authentication
The CLI requires authentication to interact with the .git platform. Run the interactive login flow:
$ gitctl auth login [1/3] Opening browser to git.dev/oauth/authorize... [2/3] Waiting for authorization... [3/3] Token saved to ~/.git/config.json ✓ Successfully authenticated as user@example.com
✅ SSO & Enterprise SAML
If your organization uses Single Sign-On, the CLI will automatically detect your domain and redirect you to your corporate IdP (Okta, Azure AD, Auth0, etc.).
Uninstalling
To completely remove the CLI and its configuration files:
# macOS (Homebrew) brew uninstall gitctl && rm -rf ~/.git # Linux sudo rm /usr/local/bin/gitctl && rm -rf ~/.git # npm npm uninstall -g @.git/cli && rm -rf ~/.git