Command reference

Use acc <command> --help to see detailed help for any command. This page is auto-generated from the CLI source (v1.1.0).

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

Option	Description
`-e, --email`	Login via email verification (no browser required)
`--auth-url <url>`	Override auth service URL

`acc logout`

Log out of the CLI

`acc whoami`

Show your identity and active project

Option	Description
`--json`	Machine-readable JSON output (for agents/CI).

Compute

`acc projects`

Manage your projects

`acc projects list`

List all projects

`acc projects create`

Create a new project

Option	Description
`--name <string>`	Project name

`acc projects update [id]`

Rename a project

`acc projects switch [id]`

Switch to a different project

`acc projects delete [id]`

Delete a project and all its services

`acc services`

Manage services in a project

Option	Description
`-p, --project <id-or-name>`	Use a specific project

`acc services list`

List all services in the project

`acc services info [id]`

Show details for a service

`acc services create`

Create a new service (from a template, Docker image, or empty server)

Option	Description
`--kind <kind>`	Service kind: template \| docker \| server \| function \| github
`--name <name>`	Service name (skips the name prompt; must be unique in the project)
`--template <id>`	Template id (for --kind template — skips the catalog browse)
`--image <ref>`	Docker image (for --kind docker — e.g. nginx:latest)
`--port <n>`	Container port (for --kind docker)
`--os <base>`	Base OS image (for --kind server — e.g. ubuntu:24.04)
`--confidential`	Deploy on a TEE: verifiable confidential compute.
`--region <region>`	Curated region: us-east \| us-west \| eu \| asia.
`--cpu <cores>`	Override CPU (vCPUs).
`--memory <size>`	Override memory (e.g. 4Gi).
`--storage <size>`	Override storage (e.g. 20Gi).
`--gpu`	Attach a GPU.
`--no-gpu`	Skip GPU.
`--gpu-model <model>`	GPU model.
`--gpu-count <n>`	Number of GPUs.
`--spend <mode>`	Spend control: payg \| budget \| stop.
`--budget-total <usd>`	Budget cap (lifetime, USD).
`--budget-monthly <usd>`	Budget cap (per month, USD).
`--stop-hours <n>`	Auto-stop after N hours.
`--stop-days <n>`	Auto-stop after N days.
`--env <pair>`	Set required env var as KEY=VALUE. Repeatable.
`--ssh-key <pubkey>`	Break-glass OpenSSH public key (--kind server). Baked into the box so you keep direct SSH if the platform channel dies.
`--ssh-key-file <path>`	Read the break-glass public key from a file (e.g. ~/.ssh/id_ed25519.pub).
`-y, --yes`	Skip confirmation prompts.

`acc services deploy [id]`

Deploy (or redeploy) a service

Option	Description
`--region <region>`	Curated region: us-east \| us-west \| eu \| asia. Omit for "Any (cheapest globally)".
`--confidential`	Deploy on a TEE: verifiable confidential compute.
`--cpu <cores>`	Override CPU (vCPUs).
`--memory <size>`	Override memory (e.g. 4Gi).
`--storage <size>`	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 <model>`	GPU model (H100, H200, A100, RTX4090, ...).
`--gpu-count <n>`	Number of GPUs.
`--spend <mode>`	Spend control: payg \| budget \| stop.
`--budget-total <usd>`	Budget cap (lifetime, USD).
`--budget-monthly <usd>`	Budget cap (per month, USD).
`--stop-hours <n>`	Auto-stop after N hours.
`--stop-days <n>`	Auto-stop after N days.
`--env <pair>`	Set required env var as KEY=VALUE. Repeatable.
`--ssh-key <pubkey>`	Break-glass OpenSSH public key (raw servers only). Ignored for container and confidential deploys.
`--ssh-key-file <path>`	Read the break-glass public key from a file (e.g. ~/.ssh/id_ed25519.pub).
`-y, --yes`	Skip confirmation prompts.

`acc services logs [id]`

Fetch logs for a service

Option	Description
`--tail <n>`	Number of log lines (default: `50`)

`acc services close [id]`

Close the active deployment on a service

`acc services delete [id]`

Delete a service (closes deployment first if running)

`acc services env`

Manage service environment variables

`acc services list [service]`

List env vars for a service

`acc services set <service> <key> <value>`

Set an env var (creates or updates)

`acc services unset <service> <key>`

Delete an env var

Option	Description
`-y, --yes`	Skip confirmation prompt

`acc services link [source] [target]`

Link two services (target connection info exposed to source)

Option	Description
`--alias <name>`	Alias used as env key prefix (e.g. DB)

`acc services unlink [source] [target]`

Remove a service link

Option	Description
`-y, --yes`	Skip confirmation prompt

`acc deployments`

List and view deployments

Option	Description
`--project <name-or-id>`	Filter by project
`--service <name-or-id>`	Filter by service
`--status <status>`	Filter by status (active, failed, closed)
`--all`	Include closed and old deployments
`-l, --limit <n>`	Max deployments to show (default: `50`)

`acc deployments list`

List all deployments

Option	Description
`--project <name-or-id>`	Filter by project
`--service <name-or-id>`	Filter by service
`--status <status>`	Filter by status
`--all`	Include closed and old deployments
`-l, --limit <n>`	Max deployments to show (default: `50`)

`acc regions`

List regions with availability and pricing

Option	Description
`--provider <name>`	Filter by provider: akash \| phala (default: akash)
`--gpu <model>`	Surface median price for a specific GPU model (e.g. h100, h200, a100, rtx4090)

`acc templates`

Browse available service templates

`acc templates list`

List available deployment templates

Option	Description
`-c, --category <category>`	Filter by category (AI_ML, WEB_SERVER, GAME_SERVER, DATABASE, DEVTOOLS, CUSTOM)

`acc templates info <templateId>`

Show detailed template information

`acc ssh <serviceId>`

Open a shell in a deployment

Option	Description
`--service <name>`	SDL service name (for multi-service deployments)
`--command <cmd>`	Command to execute (default: /bin/bash)

`acc cp <source> <dest>`

Copy a file to/from a deployment. Mark the remote side as <serviceId>:<path>.

Option	Description
`--service <name>`	SDL service name (for multi-service deployments)

`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

`acc chat`

End-to-end encrypted chat

`acc chat join [target]`

Open an interactive encrypted chat session

`acc chat send [target]`

Send one message to a room, then exit (no TTY required)

Option	Description
`--message <text>`	Message text (or pipe it on stdin)
`--reply-to <pubkey:seq>`	Thread this as a reply to a message (copy the <pubkey>:<seq> from acc chat read --json)
`--json`	Machine-readable JSON output (for agents/CI)

`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]`

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 <file>`	BRIDGE inbox file (default ~/.af-chat/<room>.in.jsonl)
`--outbox <file>`	BRIDGE outbox file (default ~/.af-chat/<room>.out)
`--exec <command>`	BOT mode: a command that reads the message (stdin JSON + AF_MSG_* env) and prints the reply, for a headless bot.
`--mention <words>`	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 <n>`	Recent messages of context passed to the brain (default 10)
`--timeout <ms>`	Max time for the brain to produce a reply (default 60000)
`--cooldown <ms>`	Minimum gap between replies — throttles runaway loops (default 0)

Billing

`acc billing`

Manage billing and subscriptions

`acc billing balance`

Show current credit balance

`acc billing topup`

Add prepaid credits with a crypto stablecoin transfer

Option	Description
`--crypto`	Pay with crypto (required — card payments are web-only)
`--amount <usd>`	Amount in USD, e.g. 25
`--chain <chain>`	Network: base \| ethereum \| arbitrum \| optimism \| polygon (default: `base`)
`--token <token>`	Stablecoin: USDC \| USDT \| DAI (default: `USDC`)
`--refund-address <address>`	Address you control that receives the Relay refund if the sent amount does not exactly match the quote (prompted if omitted)
`--org <idOrSlug>`	Organization to credit (default: first org)
`--no-wait`	Print the deposit address and exit without polling

`acc pat`

`acc pat list`

`acc pat create`

`acc pat delete`

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

On this page