Skip to main content

​
Manage Cloudgeni from Your Terminal

The Cloudgeni CLI provides command-line access to manage your cloud and git integrations, scan for infrastructure drift, and configure your Cloudgeni environment.

Authentication

Login and manage credentials

Integrations

Connect cloud providers and git repos

Drift Scanning

Detect infrastructure configuration drift

Organization

Manage organization settings

​
Installation

Install the Cloudgeni CLI with a single command: 
curl -fsSL https://github.com/Cloudgeni-ai/cloudgeni-cli/releases/latest/download/install.sh | bash
The installer automatically downloads the correct binary for your platform and adds it to your PATH.

​
Verify Installation

cloudgeni --help

​
Commands

​
cloudgeni auth

Manage authentication and credentials. 
cloudgeni auth [command]
Use this command to login to your Cloudgeni account and manage authentication tokens.

​
cloudgeni config

Manage CLI configuration settings. 
cloudgeni config [command]
Configure CLI behavior, default settings, and preferences.

​
cloudgeni org

Organization management commands. 
cloudgeni org [command]
Manage organization settings, members, and preferences.

​
cloudgeni integration

Manage cloud and git integrations. 
cloudgeni integration [command]
Connect and configure:
  • Cloud providers - AWS, Azure, GCP, OCI
  • Git providers - GitHub, GitLab, Azure DevOps

​
cloudgeni drift

Manage infrastructure drift scanning. 
cloudgeni drift [command]
Scan your infrastructure to detect configuration drift between your IaC definitions and actual cloud resources.

​
cloudgeni upgrade

Upgrade to the latest version of the CLI. 
cloudgeni upgrade
Automatically downloads and installs the newest release.

​
Getting Started

​
1. Install the CLI

curl -fsSL https://github.com/Cloudgeni-ai/cloudgeni-cli/releases/latest/download/install.sh | bash

​
2. Authenticate

cloudgeni auth login

​
3. Select Organization

cloudgeni org select

​
4. Start Using Commands

# View integrations
cloudgeni integration list

# Run drift scan
cloudgeni drift scan

​
Use Cases

​
Infrastructure Drift Detection

Detect when your cloud infrastructure has drifted from your IaC definitions: 
# Scan for drift
cloudgeni drift scan

# View drift results
cloudgeni drift status

​
Managing Integrations

Connect and manage your cloud and git providers: 
# List current integrations
cloudgeni integration list

# Add a new integration
cloudgeni integration add

​
CI/CD Integration

Use the CLI in your pipelines: 
- name: Install Cloudgeni CLI
  run: |
    curl -fsSL https://github.com/Cloudgeni-ai/cloudgeni-cli/releases/latest/download/install.sh | bash

- name: Run Drift Scan
  run: cloudgeni drift scan
  env:
    CLOUDGENI_TOKEN: ${{ secrets.CLOUDGENI_TOKEN }}

​
Troubleshooting

ProblemSolution
Command not foundRestart your terminal or add install location to PATH
Authentication failedRun cloudgeni auth login to re-authenticate
Permission deniedCheck file permissions on the CLI binary
Connection errorVerify network connectivity and firewall settings

​
Check Version

cloudgeni --version

​
Update CLI

cloudgeni upgrade

​
Next Steps

Configuration Drift

Learn about drift detection

Cloud Integrations

Connect your cloud accounts

Git Integrations

Connect your repositories

Slack Community

Get help from the community