Metadata-Version: 2.4
Name: cloudcap-cli
Version: 0.1.1
Summary: CloudCap CLI — terminal client for the CloudCap HTTP API
Author: CloudCap
License: Proprietary
Keywords: cloudcap,cli,terraform,cloud
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest>=8.2.0; extra == "dev"
Requires-Dist: build>=1.2.0; extra == "dev"

# cloudcap (PyPI)

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

## Install

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

Requires **Python 3.11+**. Only dependency: **httpx**.

## Quick start

```bash
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:

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

Full documentation: [docs/cli-install.md](../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`**.
