CLI Overview¶

The Versioner CLI is a command-line tool for tracking deployments and builds from any deployment environment.

What is the CLI?¶

A single-binary tool that submits deployment and build events to Versioner from any CI/CD system, IaC tool, or custom script.

Choosing an Integration

The CLI works with any CI/CD system or script. If your platform has a native integration, that's usually simpler. For custom tooling that needs full HTTP control, use the REST API instead.

Key Features¶

🚀 Easy Installation¶

Single static binary with no dependencies. See the Installation guide for all platforms.

🔍 Auto-Detection¶

Automatically detects build numbers, Git SHAs, branches, deployer info, and build URLs in many supported systems.

🔄 Retry Logic¶

Built-in retry with exponential backoff for reliable event delivery.

🛡️ Secure by Default¶

API keys via environment variables, security warnings for unsafe usage, and no credentials stored on disk.

Quick Example¶

Track a deployment in any CI/CD system:

# Set your API key
export VERSIONER_API_KEY="sk_mycompany_k1_..."

# Track a deployment
versioner track deployment \
  --product my-service \
  --version 1.2.3 \
  --environment production \
  --status success

Additional metadata is auto-detected based on your CI/CD system.

Next Steps¶

Install the CLI - Download and install
Learn usage - Commands and configuration
Set up CI/CD integration - Auto-detect metadata in your CI/CD system

Support¶

CLI Issues: GitHub Issues