The acira CLI

The acira command-line tool lets you pull a site to your machine, edit it in any editor, preview it locally, and publish it back. It's the developer's path into the platform — the same projects the AI agent builds, on your disk, under your version control.

Install

# macOS / Linux
curl -fsSL https://cli.acira.ai/install.sh | sh

# Windows (PowerShell)
irm https://cli.acira.ai/install.ps1 | iex

The installer verifies the release signature before installing. Run acira upgrade to update to the latest signed release at any time.

Sign in

There's no separate sign-up — signing in with a new email address creates your account. You'll get a 6-digit code by email, and the machine becomes a connected device on your account:

acira login     # enter your email, then the code we send you
acira whoami    # show who you're signed in as

Sign-in also runs in two steps, so an AI coding assistant can do it for you while you supply the email address and the code: acira login --email <address>, then acira login --code <code>. Building sites needs an agency account: acira agency create "<name>" sets one up, and acira billing gives you the link to set up payment.

A CLI sign-in lasts 90 days and reaches only the sites your account already reaches. For CI, mint an automation credential with acira token create <name> --expires <duration> --output <file> from a connected machine — it's written to a file, never printed — and set it as ACIRA_TOKEN in the environment. There's no credential flag, so secrets stay out of your shell history. See Connected devices.

The edit loop

acira pull my-site      # download the site to ./my-site
acira preview           # run it locally with live reload
# ...edit files...
acira lint              # validate locally
acira publish -m "..."  # take it live
acira status            # see local changes and whether the live site moved on

Pulling into an existing project does a three-way sync so you can pull the latest live version and keep your local edits.

Command reference

Command	What it does
login, logout, whoami, list	Sign in, sign out, show identity, list accessible sites
init	Set up your workspace: the AGENTS.md guide for AI editors, plus what account setup is left
agency create <name>	Create your agency account (agrees to the Agency Terms)
billing	Get the link to set up or fix your agency's subscription
devices	List the devices connected to your account, and revoke any of them
token create <name>	Mint an automation credential for CI into a file (expiry required)
create <name>	Create a new site and scaffold it locally (--country fixes where its data lives)
pull <site> [dir]	Download a site (three-way sync into an existing project)
preview	Local dev server with live reload and the real runtime
status	Local changes vs. the pulled version, how much the next publish uploads (largest files, anything over the 100 MB per-file limit), and staleness
lint	Validate templates, schemas, and logic locally
publish -m "<msg>"	Publish the site live
image generate "<prompt>"	Generate an image with AI into the project (--aspect, --resolution 1k|2k, --out); uses one of the site's monthly AI images and goes live with your next publish
image edit <image> "<instruction>"	Edit an existing image with AI into a new file beside it (or --out); uses one of the site's monthly AI images
logs	Recent production console output and errors
deployments	Deployment history
rollback <id>	Re-publish a previous deployment
language	List the site's languages; add/set/rm to change them
db <op> <table>	Manage runtime database rows (query/get/create/update/delete/restore/export/import)
backup <op>	Point-in-time data recovery (bookmark/restore/undo/list)
upgrade	Update the CLI to the latest signed release

Add --json to most commands for machine-readable output.

Good to know

• Generated files — assets/styles.css and assets/scripts.js are produced by the platform on every publish. Don't hand-edit them.
• Publishing runs checks — see Publishing & safety for the gates that run when you publish.
• AI editors — run acira init so Claude Code, Cursor, and others understand the platform.
• Hand-authored languages are CLI-only — acira language add <code> --no-translate adds a language you translate yourself, which the app doesn't offer. See Internationalization.
• Safe in automation — in CI, a pipe, or under an AI agent the CLI never prompts. If something genuinely needs a person — signing in, setting up an agency, paying — it exits straight away with a distinct code and prints the one command to run. Buying a domain works the same way: acira domain register and acira domain transfer only print a link for you to open and approve in your browser, never for an AI agent to open.