CLI
CLI overview
acc is the unified command line interface to Alternate Clouds - deploy AI
agents, containers, GPU workloads, and confidential (TEE) services to
decentralized infrastructure from your terminal.
Install
npm install -g @alternatefutures/acc
acc --versionRequires Node.js 18.18.2 or later.
Log in
acc login # opens the browser to authorize the CLI
acc login --email # email verification, no browser required
acc whoami # verify who you are and your active projectCommand groups
| Group | Commands | What it does |
|---|---|---|
| Account | login, logout, whoami, orgs | Authentication, organizations, your own model-provider keys |
| Compute | projects, services, deployments, regions, templates, ssh, cp, attest | Create, deploy, and manage services |
| Chat | chat join, chat send, chat read, chat agent | End-to-end-encrypted rooms, including agent bridges |
| Swarms | init, add, create, agents, swarms, run, tasks, secrets, models | Build, deploy, and talk to a team of agents. See Deploy a swarm of agents. |
| Billing | billing balance, billing topup, pat | Credits, topups, personal access tokens |
See the full command reference - it is auto-generated from the CLI source, so it always matches the released CLI.
A 60-second deploy
acc login
acc projects create --name my-project
acc services create --kind docker --image nginx:latest --port 80 -y
acc services list
acc services logsFor agents and CI
Every command works non-interactively with environment variables:
export AF_TOKEN=<personal-access-token> # from `acc pat create`
export AF_PROJECT_ID=<project-id>
acc whoami --json # machine-readable pre-flight check
acc services deploy -yMachine-readable docs
This entire docs site is available as plain markdown for AI agents: fetch
/llms.txt for an index or /llms-full.txt for everything in one
file. Every page also has a Copy Markdown button.