Skip to main content

CLI Overview

The Cloudgeni CLI is a Bun-based command-line client. Use it when you want:
  • Non-interactive automation
  • JSON output for scripts
  • Simple access to the same organization, integration, and scan surfaces the UI uses

Useful Global Flags

  • --json or --output json for machine-readable output
  • --non-interactive to disable prompts
  • --token to override the bearer token for a single command

Common Commands

cloudgeni auth login
cloudgeni auth status

cloudgeni org list --json
cloudgeni integration list --org <org>

cloudgeni repo static-analysis create --org <org> --repo <repo>
cloudgeni repo iac-scan create --org <org> --repo <repo>

cloudgeni drift scans list --org <org>
cloudgeni cloud resources list --org <org> --integration <integration>

Integration Examples

GitHub integration creation is exposed directly:
cloudgeni integration create github \
  --org <org> \
  --wait \
  --print-url
Azure cloud integration creation is also available:
cloudgeni integration create azure \
  --org <org> \
  --subscription <subscription-id> \
  --tenant <tenant-id> \
  --name <integration-name> \
  --credential-client-id <client-id> \
  --credential-client-secret <client-secret>

How To Think About It

The CLI is best used as a thin automation client for Cloudgeni’s API. If you are already in CI or scripting territory, you can choose between:
  • The CLI for convenience and structured output
  • Direct API calls for full control
Both models are valid in the current product.

Next

See Scanning API if you want the raw HTTP endpoints behind the scan commands.