Skip to content

CLI

The conway CLI is a single static binary that wraps the REST API one-to-one. When stdout is not a TTY it emits JSON automatically (or force it with --json), so it scripts cleanly.

Install

sh
curl -fsSL https://api.agentcloud.ac/install.sh | sh

Detects macOS/Linux + amd64/arm64 and installs to /usr/local/bin/conway (set CONWAY_INSTALL_DIR to override). The binary is served by the platform itself — no package manager or GitHub release needed. Direct download: https://api.agentcloud.ac/dl/conway-<os>-<arch>.

Configuration

Resolved in order: flags > environment > ~/.conway/config.yaml.

sh
export CONWAY_ENDPOINT=https://api.agentcloud.ac
export CONWAY_TOKEN=<token>
export CONWAY_PROJECT=my-app    # default project for commands that need one

Command map

conway init <name>                     create a project
conway deploy [--service s] [--dir d]  build & deploy a directory
conway status                          full project state tree
conway services list                   list services
conway services scale <s> --replicas N scale
conway rollback [--service s] [--to r] roll back
conway restart <s>                     rolling restart
conway logs [--service s] [-f]         stream logs
conway env set K=V ...                 set env vars
conway env list                        list env names
conway add postgres|redis|mongo        provision a datastore
conway db info <name>                  datastore status
conway db query <name> "<cmd>"         run SQL / redis command
conway db backups <name>               list backups
conway db backup <name>                back up now
conway db restore <name> --backup <k>  restore
conway db delete <name> --confirm      delete a datastore
conway tokens issue --caps …           mint a scoped token
conway tokens list | revoke <id>       manage tokens (admin)
conway projects list                   list projects
conway delete <name> --confirm         delete a project

Every command takes --json. Errors print the structured {code, message, hint} so you always know the next step.

Deployed on AgentCloud itself.