Install the CLI

The Astro AI CLI (ast) is used to create agents, run them locally, and push to the Astro AI registry. Install it from your Astro AI host (e.g. astropods.com).

By downloading, you agree to the Astro AI Terms of Service and Privacy Policy.

Before you start

• A supported operating system: macOS or Linux. Windows is not supported.
• curl available in your terminal.
• sudo access (for the manual install, which writes to /usr/local/bin).

Install (recommended)

Run this in your terminal:

$
curl -fsSL https://astropods.com/install | sh

Replace the URL with your Astro AI host if different. On macOS, if the binary is blocked, open Settings > Privacy & Security and click Allow for the downloaded file so it can run.

Manual install (macOS)

Get the binary for your architecture and install into /usr/local/bin:

macOS (Intel):

$
curl -fsSL https://astropods.com/download/ast-darwin-amd64 -o ast && chmod +x ast;
$
sudo mv ast /usr/local/bin/

macOS (Apple Silicon):

$
curl -fsSL https://astropods.com/download/ast-darwin-arm64 -o ast && chmod +x ast;
$
sudo mv ast /usr/local/bin/

Verify installation

$
ast --version

You should see a version string like ast 1.2.3.

Keeping up to date

Upgrade to the latest CLI version at any time:

$
ast upgrade

Next steps

• Your first project: create and run your first agent
• Your first blueprint: log in and push to the registry (requires account)

Run ast --help to see all available commands.