Astrato CLI

The astrato command configures, develops, builds and publishes Astrato Apps. See the CLI reference for installation access, commands and options.

Requires Node.js >=24.18.0 <25.

npm install --global @astrato-io/cli
astrato --version
astrato --help

Package installation access is separate from astrato login. Follow the installation instructions for the package release available to your organization.

Develop an app

In an existing Vite project, select your semantic layer and sign in:

astrato init . --semantic-layer-id YOUR_SEMANTIC_LAYER_ID
astrato login
astrato dev

Approve the device login yourself. Open the sign-in URL printed by astrato dev; the raw Vite port does not provide the Astrato runtime. Keep that local link private while the process runs. The CLI stores refresh credentials in your OS keyring and keeps account credentials out of the app. Remote browsers and forwarded ports are unsupported.

Reload the app after changing your semantic model to refresh metadata. Queries use the real Astrato platform and your current permissions; the CLI does not emulate Astrato services.

Build and publish

astrato validate
astrato build
astrato publish --help
astrato publications --help

build produces and validates local static output without requiring login. Publishing needs an enabled Astrato environment and publication access, and replaces the publication's current app. Use the command-specific help and publication documentation before publishing. --json provides machine-readable results for supported commands.

Browser apps use Astrato App runtime to access governed data.