☁️ Alternate Clouds CLI

Deploy and manage services from your terminal.

Install

npm install -g @alternatefutures/acc

Requires Node.js >= 18.

Quick Start

acc login
acc projects create --name my-project
acc services create
acc services deploy
acc services logs

Commands

Projects

acc projects list
acc projects create --name my-project
acc projects switch [id]
acc projects update [id]
acc projects delete [id]

Services

acc services list
acc services info [id]
acc services create
acc services deploy [id]
acc services deploy [id] --region us-east     # Phase 46: pin to a curated region
acc services logs [id] --tail 100
acc services close [id]
acc services delete [id]
acc services --project <id-or-name> list

Regions (Phase 46)

acc regions                                    # list us-east, us-west, eu, asia with live availability
acc regions --provider akash
acc regions --provider phala                   # → "Phala Cloud is currently single-region"
acc regions --gpu h100                         # surface median price for a specific GPU model

acc services deploy --region <region> constrains your deploy to one of the four curated buckets (us-east, us-west, eu, asia). Omit the flag for "Any (cheapest globally)" — today's default behavior. If no provider in the chosen region responds, the CLI prints alternatives + the exact retry commands.

Deployments

acc deployments
acc deployments --all
acc deployments --project <id-or-name> --status ACTIVE
acc deployments list --service api --limit 20

Shell Access

acc ssh <serviceId>
acc ssh <serviceId> --command /bin/sh

Auth

acc login
acc login --email
acc logout

For CI/CD, use environment variables:

export AF_TOKEN="your_personal_access_token"
export AF_PROJECT_ID="your_project_id"

Billing

acc billing balance

Development

pnpm install
pnpm build
pnpm test
npm link

Related

• service-auth — Auth + billing + AI proxy
• service-cloud-api — GraphQL API
• web-app — Dashboard
• npm · Changelog · Security

AGPL-3.0-only