.git â€ē Getting Started â€ē Introduction

Introduction

v2.4.0 Last updated: Oct 12, 2025 ⏱ī¸ 5 min read

.git is a modern, unified developer platform designed to streamline your workflow from local development to global production. It combines intelligent version control, automated CI/CD, edge deployments, and real-time observability into a single cohesive experience.

ℹī¸
Note: This documentation covers .git v2.x. If you're using an older version, please switch using the version selector in the top navigation.

Why .git?

Traditional developer toolchains fragment your workflow across multiple platforms. .git unifies these processes:

  • Zero-Config Deployments: Push code and go live in seconds with automatic framework detection.
  • Edge-First Architecture: Instant global distribution across 300+ locations without manual CDN setup.
  • AI-Assisted CI/CD: Smart pipelines that predict failures, optimize builds, and auto-merge safe changes.
  • Built-in Observability: Logs, metrics, and traces unified alongside your codebase.

Installation

Install the .git CLI using your preferred package manager. Node.js 18+ is required.

Terminal 
# Using npm
npm install -g @git/cli

# Using yarn
yarn global add @git/cli

# Using pnpm
pnpm add -g @git/cli

# Verify installation
git --version  # → .git CLI v2.4.0

Initializing a Project

Start a new project or connect an existing repository with a single command:

Terminal 
# Initialize new project
git init my-app

# Connect existing repo
git connect https://github.com/org/repo

# Auto-configure environment
git setup --env production

Configuration File

All project settings are managed through .gitconfig.json at your repository root. Here's a basic example:

.gitconfig.json 
{
  "project": "my-app",
  "framework": "auto",
  "build": {
    "command": "npm run build",
    "output": "dist"
  },
  "deploy": {
    "regions": ["us-east", "eu-west", "ap-southeast"],
    "autoPreview": true
  }
}
⚠ī¸
Important: Never commit secrets or API keys to .gitconfig.json. Use git secrets or environment variables for sensitive data.

Available Commands

Command Description Flags
git init Initialize a new .git project --template, --framework
git deploy Push changes to production --prod, --staging, --force
git logs View deployment & build logs --live, --follow, --region
git secrets Manage environment variables --set, --get, --delete

Next Steps

Continue exploring the documentation to master your workflow: