Astria CLI Reference

All Astria operations go through the bundled astria command-line tool. It handles authentication, the API base URL, and workspace scoping for you — never build raw curl calls and never read API tokens from environment variables.

Output is JSON on stdout, so you can parse ids and image URLs directly.

Authentication

astria resolves credentials automatically:

1. Environment variables, if present (the Astria web app injects these).
2. ~/.astria/config.json, written by astria login.

If a command fails with "not authenticated", tell the user to run:

astria login          # prompts for an API key (astria.ai/users/edit/api)