☁️ Alternate Clouds CLI

Deploy and manage services from your terminal.

---

Install

npm install -g @alternatefutures/cli

Requires Node.js >= 18.

---

Quick Start

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

---

Commands

Projects

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

Services

af services list
af services info [id]
af services create
af services deploy [id]
af services logs [id] --tail 100
af services close [id]
af services delete [id]
af services --project <id-or-name> list

Deployments

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

Shell Access

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

Auth

af login
af login --email
af logout

For CI/CD, use environment variables:

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

Billing

af 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