.git CLI Reference

git init

#

Usage

git init [project-name] [options]

Initialize a new .git project in the current directory. Sets up the repository structure, configures default branching, and connects to the .git cloud pipeline.

Flags

Flag	Description	Type
--framework-f	Auto-detect and configure build settings for a specific framework	String
--region	Specify the default deployment region	String
--env	Set the initial environment variables from a file	Path
--dry-run	Preview initialization without creating files	Boolean

Examples

Basic initialization

git init my-app ✓ Project initialized successfully

With framework detection

git init my-app --framework nextjs --region us-east-1 ✓ Configured Next.js pipeline

git deploy

#

Usage

git deploy [environment] [options]

Deploy your application to the specified environment. Supports automatic preview URLs, zero-downtime rollouts, and instant rollbacks.

Flags

Flag	Description	Type
--prod-p	Deploy directly to production (overrides branch rules)	Boolean
--preview	Create a preview deployment for the current branch	Boolean
--wait	Block until deployment is live and healthy	Boolean
--timeout	Max wait time in seconds	Number
--force	Skip pre-deploy checks and force push	Boolean

Examples

Deploy to production

git deploy --prod --wait ✓ Deployed to production in 4.2s → https://prod.git.dev

Preview deployment

git deploy --preview ✓ Preview URL: https://feat-auth-123.git.dev

git config

#

Usage

git config [key] [value]

Manage project and user-level .git configurations. Handles API tokens, default regions, deployment strategies, and plugin preferences.

Flags

Flag	Description	Type
--global-g	Apply configuration to all projects	Boolean
--local	Apply configuration only to current project	Boolean
--format	Output format: json, yaml, or table	String
--unset	Remove a configuration key	Boolean

Examples

Set default region

git config set region eu-west-1 ✓ Configuration updated

List all configs as JSON

git config list --format json { "region": "eu-west-1", "deployStrategy": "rolling" }

git logs

#

Usage

git logs [options]

View deployment history, build artifacts, and pipeline execution logs. Filters by status, date, or environment.

Flags

Flag	Description	Type
--status	Filter by status: success, failed, running	String
--env	Filter by environment	String
--limit-n	Number of logs to return	Number
--tail	Stream logs in real-time	Boolean
--json	Output structured JSON for scripting	Boolean

Examples

Last 5 successful deployments

git logs --status success --limit 5 2025-01-15 14:23:01 [prod] v2.4.1 3.2s ✓ 2025-01-14 09:11:45 [prod] v2.4.0 2.8s ✓

Stream production logs

git logs --env prod --tail [streaming...]

git secrets

#

Usage

git secrets [key] [options]

Securely manage environment variables and API keys. All values are encrypted at rest and injected at build/deploy time. Never commit secrets to version control.

Flags

Flag	Description	Type
--mask-m	Mask value output for security	Boolean
--file-f	Import secrets from .env or JSON file	Path
--scope	Limit to: all, production, staging, dev	String
--interactive-i	Open secure TUI for input	Boolean

Examples

Add secret interactively

git secrets add DATABASE_URL --interactive ✓ Secret encrypted and stored

Import from .env

git secrets add --file .env.production ✓ 12 secrets imported

git rollback

#

Usage

git rollback [deployment-id|version] [options]

Instantly revert to a previous deployment. Preserves database state and supports graceful traffic shifting.

Flags

Flag	Description	Type
--to-t	Target deployment ID or version tag	String
--gradual	Shift traffic in 10% increments	Boolean
--force	Skip health checks during rollback	Boolean

Examples

Rollback to specific version

git rollback --to v2.3.8 ✓ Traffic shifted to v2.3.8