Guepard CLI 0.27.17

Guepard CLI 0.27.17

Platforms Released

• linux
• macos
• windows

Installation

macOS (Homebrew)

brew tap guepard-corp/guepard
brew install guepard

Linux (Homebrew)

brew tap guepard-corp/guepard
brew install guepard

Windows (Chocolatey)

choco install guepard

Linux (Snap)

sudo snap install guepard

Direct Downloads

macOS (Intel)

# Download and extract
curl -L https://github.com/Guepard-Corp/guepard-cli/releases/download/0.27.17/guepard-cli-0.27.17-macos-amd64.tar.gz | tar -xz

# Move to PATH
sudo mv guepard /usr/local/bin/

# Verify installation
guepard --version

macOS (Apple Silicon)

# Download and extract
curl -L https://github.com/Guepard-Corp/guepard-cli/releases/download/0.27.17/guepard-cli-0.27.17-macos-arm64.tar.gz | tar -xz

# Move to PATH
sudo mv guepard /usr/local/bin/

# Verify installation
guepard --version

Windows

# Download and extract
Invoke-WebRequest -Uri "https://github.com/Guepard-Corp/guepard-cli/releases/download/0.27.17/guepard-cli-0.27.17-windows-amd64.zip" -OutFile "guepard-cli.zip"
Expand-Archive -Path "guepard-cli.zip" -DestinationPath "."

# Add to PATH (optional)
# Add the directory containing guepard.exe to your system PATH

# Verify installation
.\guepard.exe --version

SHA256 Checksums

• Linux AMD64: b21d4a014b92c3c0669992e9faae79274d82caa373689e4bb5c76039ac4e560f
• Linux ARM64: fb6ecd29a106233a06694a4c41f66fdddfe77fff9be4d0f15b9b60957e784810
• macOS AMD64: f28c051eab075dda7f708cef79bca8868f22f7be064a9c629cdbcec94c9712b4
• macOS ARM64: c32041855705f9d7b616d5e5e54117cd46adbb30b1e37e7360ca3dd1498f29ba
• Windows AMD64: 78d0ad3592d6ea31a5f5a9754b5b71a39900449dae531fcc28e72c1a973cdd65

What's New

• Multi-platform support - Native binaries for macOS, Windows, and Linux
• Git, but for Data - Familiar Git-like interface for database management
• Database version control - Create snapshots, manage branches, and track changes
• API v0.4.4 integration - Latest backend features and improvements
• Enhanced performance profiles - Configurable compute resources
• Cross-platform keyring support - Secure credential storage
• Beautiful table outputs - Colorized, rounded tables for better readability
• Interactive deployment mode - Guided setup for complex configurations

Quick Start

1. Authentication

# Interactive login (recommended)
guepard login

# Or direct token login for CI/CD
guepard login --code your-access-token

2. Create Your First Deployment

# Interactive mode (recommended for beginners)
guepard deploy --interactive

# Or command-line deployment
guepard deploy \
  --database-provider PostgreSQL \
  --database-version 16 \
  --region us-west \
  --instance-type REPOSITORY \
  --datacenter aws \
  --repository-name myapp \
  --database-password secret123

3. Create Database Snapshots

# Create a snapshot (commit)
guepard commit \
  --message "Initial database setup" \
  --deployment-id <deployment_id> \
  --branch-id <branch_id>

4. Manage Branches

# List branches
guepard branch --deployment-id <deployment_id>

# Create a new branch
guepard branch \
  --deployment-id <deployment_id> \
  --snapshot-id <snapshot_id> \
  --name feature-auth \
  --checkout \
  --ephemeral

5. Switch Between Branches

# Checkout a branch
guepard checkout \
  --deployment-id <deployment_id> \
  --branch-id <branch_id>

6. View History and Logs

# View commit history with git graph
guepard list commits --deployment-id <deployment_id> --graph

# View deployment logs
guepard log --deployment-id <deployment_id> --follow

7. Manage Compute Instances

# Check compute status
guepard compute status --deployment-id <deployment_id>

# Start compute instance
guepard compute start --deployment-id <deployment_id>

# Stop compute instance
guepard compute stop --deployment-id <deployment_id>

# View compute logs
guepard compute logs --deployment-id <deployment_id>

8. List Resources

# List all deployments
guepard list deployments

# List branches for a deployment
guepard list branches --deployment-id <deployment_id>

# List commits for a deployment
guepard list commits --deployment-id <deployment_id>

9. Check Usage

# View account usage and quotas
guepard usage

Technical Details

• Rust version: Latest stable
• Target platforms: macOS, Windows, Linux
• Features: Platform-specific keyring support, beautiful table outputs
• Dependencies: Self-contained binaries
• API compatibility: v0.4.4
• Authentication: Browser-verified token issuance with direct token support

Command Reference

Core Commands

• guepard deploy - Create and manage database deployments
• guepard commit - Create database snapshots
• guepard branch - Manage branches for isolated development
• guepard checkout - Switch between branches or snapshots
• guepard log - View deployment logs with filtering

Management Commands

• guepard compute - Manage compute instances (start/stop/status/logs)
• guepard list - List deployments, branches, commits with customizable columns
• guepard usage - View account usage and quotas

Authentication Commands

• guepard login - Authenticate with Guepard account
• guepard logout - Sign out and clear credentials

Configuration Commands

• guepard config - Configure API endpoints and settings

Getting Help

• Run guepard --help for general help
• Run guepard <command> --help for command-specific help

Documentation

• Website: https://www.guepard.run
• Documentation: https://docs.guepard.run
• GitHub: https://github.com/Guepard-Corp/guepard-cli