ArchAstro

Developer Docs

Getting Started

Create your app in the developer portal, then connect the CLI.

What you'll do

Create your developer account and app, then install and sign in with the CLI. Creating an app is an explicit action; CLI setup does not create agents or other resources for you.

1. Create your app

Open developers.archastro.ai, create an account, and verify your email. Select Create your first app in the developer workspace and give it a name. If you already have an app, open it instead.

The app's Overview page shows Connect your CLI above analytics. This card includes installation commands and a copyable coding-agent prompt with the app's name and ID. It stays available until you dismiss it. Select CLI instructions on Overview to reopen it; dismissal is saved in this browser for your developer account and app.

2. Install the CLI

macOS

brew install ArchAstro/tools/archastro

Linux

curl -fsSL https://archastro.ai/install.sh | bash

Windows

irm https://archastro.ai/install.ps1 | iex

3. Sign in from the terminal

archastro auth login
archastro auth status

Complete browser authorization for the app you created. Confirm the account and app shown by auth status before continuing.

Your coding agent can run CLI commands directly. No coding-tool plugin or restart is required.

4. Choose what to build

Tell your coding agent what you want to build, or follow the CLI guide to connect your repository and create an agent. Confirm the intended app and requested resources before creating anything. You do not need to install a starter agent to finish onboarding.

Where to go next

  1. CLI: installation, authentication, and commands for building agents.
  2. For Coding Agents: a copyable setup prompt that stops before creating resources.
  3. Agents: agent configuration and behavior.

If sign-in fails

Confirm that you have created an app in the developer portal, then run archastro auth login again. Use archastro auth status to check the selected account and app.