aircloud-cli 0.1.0

AirCloud CLI — endpoint management, SSH, and container exec

aircloud-cli

CLI for the AirCloud platform — endpoint management, SSH access, and container shell exec.

Install

pip install aircloud-cli

Requires Python 3.9+.

Quick start

# one-time setup
aircloud config set api-key <YOUR_API_KEY>
aircloud config set api-base-url <API_BASE_URL>

# inspect endpoints
aircloud endpoints list
aircloud endpoints get <endpoint_id>

# open a shell in a container
aircloud ssh <endpoint_id>            # public-key auth, sshd-based
aircloud exec <endpoint_id>           # docker exec over WS, no sshd needed

Commands

aircloud config

Manage CLI configuration in ~/.aircloud/config.json.

aircloud config set api-key <key>
aircloud config set api-base-url <url>
aircloud config list
aircloud config get <key>

aircloud endpoints

aircloud endpoints list                          # paged list
aircloud endpoints get <id>                      # detail
aircloud endpoints start <id>
aircloud endpoints stop <id>
aircloud endpoints scale <id> --replicas N
aircloud endpoints patch <id> --command "..." --port 8080 --env KEY=VALUE
aircloud endpoints replicas <id>                 # current replicas
aircloud endpoints logs <id> [--replica-id X] [--start-line N --end-line M]

aircloud ssh

SSH into a container via WebSocket tunnel using public-key authentication.

aircloud ssh <endpoint_id>                       # auto-discover ~/.ssh/id_*
aircloud ssh <endpoint_id> -i ~/.ssh/aircloud_key
aircloud ssh <endpoint_id> -r <replica_id>       # pin to specific replica
aircloud ssh <endpoint_id> --tunnel-only         # open tunnel only

Auto-discovers identity files in this order: ~/.ssh/id_ed25519, ~/.ssh/id_ecdsa, ~/.ssh/id_rsa. Override with -i / --identity-file.

The container image must have sshd running and consume the AIRCLOUD_AUTHORIZED_KEYS environment variable (AirCloud-provided template images do this by default).

aircloud exec

Open an interactive shell in the container via docker exec over a WebSocket. Works on any image — no sshd required.

aircloud exec <endpoint_id>
aircloud exec <endpoint_id> -r <replica_id>      # pin replica
aircloud exec <endpoint_id> -c "/bin/sh"         # custom command

aircloud whoami

Print the identity associated with the current API key.

aircloud whoami

Status

This is an early functional release. Interfaces may change before 1.0.0.

License

Proprietary. © AIEEV / AirCloud.