Alternate Futures
CLI (acc)

Install the CLI

Requirements

  • Node.js 18.18.2 or later (node --version)
  • npm (bundled with Node.js)

Install

npm install -g @alternatefutures/acc

Verify the installation:

acc --version
acc --help

Renamed from af

The CLI was renamed from af to acc in 2026. If you have the old @alternatefutures/cli package installed, remove it with npm uninstall -g @alternatefutures/cli to avoid confusion - the old af binary no longer matches the current platform.

Authenticate

acc login          # browser flow: approves this CLI session from the web app
acc login --email  # email code flow, no browser needed

Confirm you are logged in:

acc whoami

Non-interactive use (CI, agents)

Create a personal access token and export it instead of logging in:

acc pat create --name ci-runner
export AF_TOKEN=<token>
export AF_PROJECT_ID=<project-id>
acc whoami --json

Updating

npm update -g @alternatefutures/acc

Troubleshooting

  • command not found: acc - your global npm bin directory is not on PATH. Run npm bin -g and add that directory to your shell profile.
  • Login loops or auth errors - run acc logout then acc login again; check acc whoami afterwards.
  • Corporate proxies - the CLI talks HTTPS to alternatefutures.ai hosts; make sure they are reachable.

CLI overview

acc is the Alternate Clouds command line interface for deploying and managing services on decentralized infrastructure.

Command reference

Complete reference for every acc command and flag, generated from the CLI source.

On this page

RequirementsInstallAuthenticateNon-interactive use (CI, agents)UpdatingTroubleshooting