Skip to content

Platform reference

These pages document the current public client contracts:

  • CLI: installation, authentication, common commands, JSON output, offline docs, generated Markdown, and man pages.
  • API: GraphQL and REST endpoints, bearer authentication, tenant selection, errors, and compatibility.
  • MCP: remote client configuration, scopes, tools, resources, and raw protocol checks.
  • astrolift.toml: deployable app/workload schema.
  • Agent packages: briefs, skills, tools, payload slices, imports, monorepos, and federated registration.
  • Workflow TOML: ordered agent pipelines and repo sync.

Versioning and source of truth

The server parser and GraphQL schema are authoritative. This site tracks the current release. A released astro binary embeds a matching portable snapshot:

astro docs list
astro docs show manifest
astro docs export ./astrolift-reference

Use astro workflow validate --server when validating workflow TOML against a specific installation. Use the dashboard's manifest preview or astro ci render to validate and render an app manifest on the target installation.

For AI clients, /llms.txt is a stable, plain-text index. The Markdown pages use semantic headings, complete code blocks, and explicit field names so they can be downloaded or indexed without rendering the website.