Skip to main content

CLI and Console

The hosted console and CLI share the same PaaS boundary. Browser users manage organizations, billing, apps, and support workflows in the console. CLI users authenticate through a browser approval flow and then use the enclava command for deploys and status.

Console routes

PathPurpose
/loginAccount login and account creation entry.
/cli/loginCLI device-code approval.
/dashboardOrganization overview, KPIs, and recent deployments.
/orgs/[slug]/keyringOrganization keyring viewer.
/orgs/[slug]/billingBilling, credits, invoices, and Bitcoin payment state.
/apps/[name]App detail and deployment history.

CLI API discovery

The shared hosted CLI API exposes discovery and health endpoints:

EndpointPurpose
/.well-known/enclavaDiscover API mode and CLI login endpoints.
/healthzLiveness.
/readyzReadiness and integration status.
/auth/device/startStart CLI device login.
/auth/device/pollPoll device-login state.
/users/meReturn authenticated CLI principal.
/platform/deployment-contextReturn public material needed for signed deployment descriptors.

Auth model

Hosted CLI login stores local credentials for the active API base URL. Browser sessions stay server-side with HTTP-only cookies. Hosted service credentials remain in the PaaS backend.