Use the CLI
Install the CLI
Download the current stable alterac.ai CLI archive, verify it, and install it for your user account on macOS, Linux, or Windows.
1. Download alterac.ai CLI
Loading current CLI downloads…
Archive links will appear after both release manifests have been validated.
2. Install alterac.ai CLI
Installation steps will appear after the selected archive has been validated. Retry the download check above when your local release origin is available.
Choose the tab for the command line you use. macOS and Linux offer Zsh and Bash; Windows offers PowerShell, Git Bash, and Command Prompt.
After the tab's commands finish, open a new terminal and run:
alterac-ai --version
The output should match the stable version shown above. Then initialize alterac.ai in a repository.
An ordinary command may report that a newer stable CLI is available. The warning names both the installed and available versions and links back to this page. The requested command still runs normally; an unavailable or invalid release check does not make it fail.
To upgrade, choose the archive for your system above, verify its SHA-256 value, and repeat the installation steps. The new executable replaces the old one. The CLI does not install or replace itself.
On macOS, the first launch may say Apple cannot verify the developer. After verifying the checksum, try the command once, open System Settings, select Privacy & Security, and use Open Anyway for alterac-ai if your organization's policy allows it. Confirm Open when macOS asks. This approves that executable; it does not require disabling Gatekeeper globally.
On Windows, SmartScreen may show Windows protected your PC. After verifying the checksum, select More info, review that the app is alterac-ai.exe, and select Run anyway if your organization's policy allows it. Do not disable SmartScreen. A managed device may intentionally prevent either exception; contact your organization instead of bypassing that policy.
If downloads are unavailable, check your connection and select Retry manifest loading. Do not construct a download URL yourself.
If a new terminal cannot find alterac-ai, see Fix repository setup. If a version warning persists after replacement, open a new terminal and confirm that alterac-ai --version reports the stable version shown above.