CLI Reference

The Acme CLI (@acme/cli) is a command-line tool for managing projects, deployments, and configuration from your terminal. This page documents every available command and its options.

Global Options

These flags are available on all commands:

Flag	Description
`--help`, `-h`	Show help for any command
`--version`, `-v`	Print the CLI version
`--verbose`	Enable verbose logging output
`--json`	Output results as JSON (useful for scripting)

`acme login`

Authenticate the CLI with your Acme Platform account.

acme login

Opens your default browser to complete the OAuth 2.0 authorization flow. A refresh token is stored locally at ~/.config/acme/credentials.json.

`acme init`

Initialize a new project in the current directory.

acme init [project-name]

Option	Description
`--template <name>`	Start from a project template (e.g., `nextjs`, `astro`, `express`)
`--no-git`	Skip Git repository initialization

`acme deploy`

Deploy the current project to Acme Platform.

acme deploy [options]

Option	Description
`--production`	Deploy to the production environment
`--preview`	Deploy to a preview environment
`--env <name>`	Deploy to a named custom environment
`--message <msg>`	Attach a deployment message

`acme status`

Display the status of the current project and its deployments.

acme status

`acme config`

Manage environment variables and project configuration.

acme config set <key> <value> [--env <environment>]
acme config get <key> [--env <environment>]
acme config list [--env <environment>]
acme config import <file> [--env <environment>]

`acme logs`

Stream real-time logs from a running deployment.

acme logs [--env <environment>] [--follow]

`acme rollback`

Roll back to the previous deployment.

acme rollback [--env <environment>]

`acme whoami`

Print the currently authenticated user and account details.

acme whoami