cloudcap (PyPI)

Terminal client for the CloudCap HTTP API: evaluate Terraform plans, deploy, optimize, and manage context from your shell.

Install

pipx install cloudcap-cli
# or
pip install cloudcap-cli

Requires Python 3.11+. Only dependency: httpx.

Quick start

export CLOUDCAP_URL="https://your-api.example.com/v1"
cloudcap login --token "YOUR_BEARER_OR_PAT"
cloudcap whoami
cloudcap evaluate plan.json --region us-east-1

Machine-readable output:

cloudcap --output json whoami
cloudcap --output json pipeline status RUN_ID

Full documentation: docs/cli-install.md in the CloudCap repo.

Configuration

• File: ~/.cloudcap/config.json (created by cloudcap login)
• Env overrides: CLOUDCAP_URL, CLOUDCAP_TOKEN, CLOUDCAP_ORG_ID, CLOUDCAP_ENV_ID

Docker (CI)

See Dockerfile in this directory; build with a wheel or pin pip install cloudcap-cli==VERSION.

Server package

The API server is published separately as cloudcap-backend. Install the CLI with pip install cloudcap-cli without pulling server dependencies. The command on PATH remains cloudcap.