# Command reference (/cli/commands)
{/* AUTO-GENERATED by scripts/generate-cli-docs.mjs from @alternatefutures/acc@1.1.0 — do not edit by hand. */}
Use `acc --help` to see detailed help for any command. This page is
auto-generated from the CLI source (v1.1.0).
## Global options [#global-options]
* `--debug` · enable debug output
* `--local` · use local dev services (separate credential slot)
* `-V, --version` · print CLI version
* `-h, --help` · help for any command
## Account [#account]
### `acc login` [#acc-login]
Log in (opens browser)
| Option | Description |
| ------------------ | -------------------------------------------------- |
| `-e, --email` | Login via email verification (no browser required) |
| `--auth-url ` | Override auth service URL |
### `acc logout` [#acc-logout]
Log out of the CLI
### `acc whoami` [#acc-whoami]
Show your identity and active project
| Option | Description |
| -------- | --------------------------------------------- |
| `--json` | Machine-readable JSON output (for agents/CI). |
## Compute [#compute]
### `acc projects` [#acc-projects]
Manage your projects
### `acc projects list` [#acc-projects-list]
List all projects
### `acc projects create` [#acc-projects-create]
Create a new project
| Option | Description |
| ----------------- | ------------ |
| `--name ` | Project name |
### `acc projects update [id]` [#acc-projects-update-id]
Rename a project
### `acc projects switch [id]` [#acc-projects-switch-id]
Switch to a different project
### `acc projects delete [id]` [#acc-projects-delete-id]
Delete a project and all its services
### `acc services` [#acc-services]
Manage services in a project
| Option | Description |
| ---------------------------- | ---------------------- |
| `-p, --project ` | Use a specific project |
### `acc services list` [#acc-services-list]
List all services in the project
### `acc services info [id]` [#acc-services-info-id]
Show details for a service
### `acc services create` [#acc-services-create]
Create a new service (from a template, Docker image, or empty server)
| Option | Description |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| `--kind ` | Service kind: template \| docker \| server \| function \| github |
| `--name ` | Service name (skips the name prompt; must be unique in the project) |
| `--template ` | Template id (for --kind template — skips the catalog browse) |
| `--image [` | Docker image (for --kind docker — e.g. nginx:latest) |
| `--port ` | Container port (for --kind docker) |
| `--os ` | Base OS image (for --kind server — e.g. ubuntu:24.04) |
| `--confidential` | Deploy on a TEE: verifiable confidential compute. |
| `--region ` | Curated region: us-east \| us-west \| eu \| asia. |
| `--cpu ` | Override CPU (vCPUs). |
| `--memory ` | Override memory (e.g. 4Gi). |
| `--storage ` | Override storage (e.g. 20Gi). |
| `--gpu` | Attach a GPU. |
| `--no-gpu` | Skip GPU. |
| `--gpu-model ` | GPU model. |
| `--gpu-count ` | Number of GPUs. |
| `--spend ` | Spend control: payg \| budget \| stop. |
| `--budget-total ` | Budget cap (lifetime, USD). |
| `--budget-monthly ` | Budget cap (per month, USD). |
| `--stop-hours ` | Auto-stop after N hours. |
| `--stop-days ` | Auto-stop after N days. |
| `--env ` | Set required env var as KEY=VALUE. Repeatable. |
| `--ssh-key ` | Break-glass OpenSSH public key (--kind server). Baked into the box so you keep direct SSH if the platform channel dies. |
| `--ssh-key-file ` | Read the break-glass public key from a file (e.g. \~/.ssh/id\_ed25519.pub). |
| `-y, --yes` | Skip confirmation prompts. |
### `acc services deploy [id]` [#acc-services-deploy-id]
Deploy (or redeploy) a service
| Option | Description |
| ------------------------ | -------------------------------------------------------------------------------------------------- |
| `--region ` | Curated region: us-east \| us-west \| eu \| asia. Omit for "Any (cheapest globally)". |
| `--confidential` | Deploy on a TEE: verifiable confidential compute. |
| `--cpu ` | Override CPU (vCPUs). |
| `--memory ` | Override memory (e.g. 4Gi). |
| `--storage ` | Override storage (e.g. 20Gi). |
| `--gpu` | Attach a GPU. Use --gpu-model and --gpu-count to specify. |
| `--no-gpu` | Skip GPU even if the template defaults to one. |
| `--gpu-model ` | GPU model (H100, H200, A100, RTX4090, ...). |
| `--gpu-count ` | Number of GPUs. |
| `--spend ` | Spend control: payg \| budget \| stop. |
| `--budget-total ` | Budget cap (lifetime, USD). |
| `--budget-monthly ` | Budget cap (per month, USD). |
| `--stop-hours ` | Auto-stop after N hours. |
| `--stop-days ` | Auto-stop after N days. |
| `--env ` | Set required env var as KEY=VALUE. Repeatable. |
| `--ssh-key ` | Break-glass OpenSSH public key (raw servers only). Ignored for container and confidential deploys. |
| `--ssh-key-file ` | Read the break-glass public key from a file (e.g. \~/.ssh/id\_ed25519.pub). |
| `-y, --yes` | Skip confirmation prompts. |
### `acc services logs [id]` [#acc-services-logs-id]
Fetch logs for a service
| Option | Description |
| ------------ | ----------------------------------- |
| `--tail ` | Number of log lines (default: `50`) |
### `acc services close [id]` [#acc-services-close-id]
Close the active deployment on a service
### `acc services delete [id]` [#acc-services-delete-id]
Delete a service (closes deployment first if running)
### `acc services env` [#acc-services-env]
Manage service environment variables
### `acc services list [service]` [#acc-services-list-service]
List env vars for a service
### `acc services set ` [#acc-services-set-service-key-value]
Set an env var (creates or updates)
### `acc services unset ` [#acc-services-unset-service-key]
Delete an env var
| Option | Description |
| ----------- | ------------------------ |
| `-y, --yes` | Skip confirmation prompt |
### `acc services link [source] [target]` [#acc-services-link-source-target]
Link two services (target connection info exposed to source)
| Option | Description |
| ---------------- | -------------------------------------- |
| `--alias ` | Alias used as env key prefix (e.g. DB) |
### `acc services unlink [source] [target]` [#acc-services-unlink-source-target]
Remove a service link
| Option | Description |
| ----------- | ------------------------ |
| `-y, --yes` | Skip confirmation prompt |
### `acc deployments` [#acc-deployments]
List and view deployments
| Option | Description |
| ------------------------ | ----------------------------------------- |
| `--project ` | Filter by project |
| `--service ` | Filter by service |
| `--status ` | Filter by status (active, failed, closed) |
| `--all` | Include closed and old deployments |
| `-l, --limit ` | Max deployments to show (default: `50`) |
### `acc deployments list` [#acc-deployments-list]
List all deployments
| Option | Description |
| ------------------------ | --------------------------------------- |
| `--project ` | Filter by project |
| `--service ` | Filter by service |
| `--status ` | Filter by status |
| `--all` | Include closed and old deployments |
| `-l, --limit ` | Max deployments to show (default: `50`) |
### `acc regions` [#acc-regions]
List regions with availability and pricing
| Option | Description |
| ------------------- | ------------------------------------------------------------------------------ |
| `--provider ` | Filter by provider: akash \| phala (default: akash) |
| `--gpu ` | Surface median price for a specific GPU model (e.g. h100, h200, a100, rtx4090) |
### `acc templates` [#acc-templates]
Browse available service templates
### `acc templates list` [#acc-templates-list]
List available deployment templates
| Option | Description |
| --------------------------- | ---------------------------------------------------------------------------------- |
| `-c, --category ` | Filter by category (AI\_ML, WEB\_SERVER, GAME\_SERVER, DATABASE, DEVTOOLS, CUSTOM) |
### `acc templates info ` [#acc-templates-info-templateid]
Show detailed template information
### `acc ssh ` [#acc-ssh-serviceid]
Open a shell in a deployment
| Option | Description |
| ------------------ | ------------------------------------------------ |
| `--service ` | SDL service name (for multi-service deployments) |
| `--command ` | Command to execute (default: /bin/bash) |
### `acc cp ` [#acc-cp-source-dest]
Copy a file to/from a deployment. Mark the remote side as \:\.
| Option | Description |
| ------------------ | ------------------------------------------------ |
| `--service ` | SDL service name (for multi-service deployments) |
### `acc attest ` [#acc-attest-serviceid]
Fetch the TEE attestation report for a confidential deployment
| Option | Description |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `--json` | Machine-readable JSON output (for agents/CI). |
| `--verify` | Verify the quote client-side against Intel roots (@phala/dcap-qvl; collateral from Intel PCS) and check the MRCONFIGID V1 compose\_hash. |
## Chat [#chat]
### `acc chat` [#acc-chat]
End-to-end encrypted chat
### `acc chat join [target]` [#acc-chat-join-target]
Open an interactive encrypted chat session
### `acc chat send [target]` [#acc-chat-send-target]
Send one message to a room, then exit (no TTY required)
| Option | Description |
| ------------------------- | ----------------------------------------------------------------------------------------- |
| `--message ` | Message text (or pipe it on stdin) |
| `--reply-to ` | Thread this as a reply to a message (copy the \:\ from acc chat read --json) |
| `--json` | Machine-readable JSON output (for agents/CI) |
### `acc chat read [target]` [#acc-chat-read-target]
Read room history; --watch to stream live (no TTY required)
| Option | Description |
| --------- | ------------------------------------------------------ |
| `--watch` | Stay connected and stream new messages + presence |
| `--json` | JSON snapshot; with --watch, NDJSON one event per line |
### `acc chat agent [target]` [#acc-chat-agent-target]
Participate as an agent: driver mode (you answer) or --exec bot mode
| Option | Description |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--bridge` | BRIDGE mode: stay connected (one persistent presence) and relay via files — addressed messages → inbox, lines you append to outbox → sent. Best for a live LLM agent. |
| `--inbox ` | BRIDGE inbox file (default \~/.af-chat/\.in.jsonl) |
| `--outbox ` | BRIDGE outbox file (default \~/.af-chat/\.out) |
| `--exec ` | BOT mode: a command that reads the message (stdin JSON + AF\_MSG\_\* env) and prints the reply, for a headless bot. |
| `--mention ` | Comma-separated trigger words; reply only when a message contains one (default: your display name) |
| `--all` | Reply to every message, not just when mentioned |
| `--context ` | Recent messages of context passed to the brain (default 10) |
| `--timeout ` | Max time for the brain to produce a reply (default 60000) |
| `--cooldown ` | Minimum gap between replies — throttles runaway loops (default 0) |
## Billing [#billing]
### `acc billing` [#acc-billing]
Manage billing and subscriptions
### `acc billing balance` [#acc-billing-balance]
Show current credit balance
### `acc billing topup` [#acc-billing-topup]
Add prepaid credits with a crypto stablecoin transfer
| Option | Description |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `--crypto` | Pay with crypto (required — card payments are web-only) |
| `--amount ` | Amount in USD, e.g. 25 |
| `--chain ` | Network: base \| ethereum \| arbitrum \| optimism \| polygon (default: `base`) |
| `--token ` | Stablecoin: USDC \| USDT \| DAI (default: `USDC`) |
| `--refund-address ` | Address you control that receives the Relay refund if the sent amount does not exactly match the quote (prompted if omitted) |
| `--org ` | Organization to credit (default: first org) |
| `--no-wait` | Print the deposit address and exit without polling |
### `acc pat` [#acc-pat]
### `acc pat list` [#acc-pat-list]
### `acc pat create` [#acc-pat-create]
### `acc pat delete` [#acc-pat-delete]
## Environment variables [#environment-variables]
| Variable | Purpose |
| ----------------- | ------------------------------------------------------------- |
| `AF_TOKEN` | Personal access token (overrides stored login, for CI/agents) |
| `AF_PROJECT_ID` | Project to operate on (for CI/agents) |
| `AF_ORG_ID` | Organization override |
| `AF_API_URL` | Override cloud API base URL |
| `AF_AUTH_API_URL` | Override auth service URL |
]