Cloudlink CLI

Use Cloudlink from your terminal for deploy notifications, scans, regressions, and cost summaries.

Location

The CLI ships in the cloudlink-agents repo as cloudlink_cli.py.

Environment variables

Variable	Description
`CLOUDLINK_API_URL`	Your Cloudlink API base URL
`CLOUDLINK_API_KEY`	Your API key for authenticated requests

Quick start

export CLOUDLINK_API_URL=https://cloudlink-agents-production.up.railway.app
export CLOUDLINK_API_KEY=cl_live_your_key

python cloudlink_cli.py health
python cloudlink_cli.py stats
python cloudlink_cli.py costs --days 30

Common commands

# List open regressions
python cloudlink_cli.py regressions list --status open

# Record a deploy from CI or your laptop
python cloudlink_cli.py deploys create \
  --service "Amazon EC2" \
  --version "$(git rev-parse --short HEAD)" \
  --environment production \
  --source github-actions

# Trigger a scan or action loop
python cloudlink_cli.py scan
python cloudlink_cli.py run-once

# Check budget thresholds immediately
python cloudlink_cli.py budget-check

CI usage

The CLI is a good fit for GitHub Actions, GitLab CI, Jenkins, and internal deploy tooling when you want a simple wrapper around the REST API without writing curl by hand.