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.

Setup and discovery¶

Discover capabilities on the target installation.
Set up apps, agents, and workflows with concrete CLI commands.
Give an app a deadline with temporary apps.
Author bounded returns and serial collections and inspect recorded rounds, attempts and exact item identities.
Provision shared services once and attach consumers.
Answer agent questions and approvals from the agent inbox.
Receive signed completion callbacks with durable retries, backoff, and manual replay.

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 search '"request file"'
astro docs export ./astrolift-reference
astro docs man ./man1

astro docs search finds terms and quoted phrases in the embedded guides without network access or login. astro docs man generates section-1 man pages from the executing command tree.

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.