@drmhse/authos-cli

CLI scaffolding tool for AuthOS integrations.

AuthOS release 0.8.5 Latest-only documentation
Updated Jul 15, 2026
On this page

Scaffolding CLI for AuthOS integration templates.

Install

npm install -g @drmhse/authos-cli

Common commands

authos init
authos add login-form
authos add org-switcher
authos add user-profile
authos provision act --base-url https://auth.example.com --act-url https://act.example.com

For a fresh standalone install, use the AuthOS URL printed by sudo ./install.sh. The default local URL is usually http://localhost:3001 on the AuthOS host.

authos init writes framework-specific env vars:

  • Next.js: AUTHOS_BASE_URL and NEXT_PUBLIC_AUTHOS_URL
  • Vite React/Vue: AUTHOS_BASE_URL and VITE_AUTHOS_BASE_URL
  • Nuxt: AUTHOS_BASE_URL and NUXT_PUBLIC_AUTHOS_BASE_URL

ACT provisioning

authos provision act bootstraps the ACT organization and mobile service in an AuthOS deployment. The command is idempotent and can:

  • create or update the act organization
  • create or update the ACT mobile service, redirect URIs, and GitHub scopes
  • configure BYOO GitHub credentials when provided
  • create or reuse the service API key used for provider-token access
  • write the one-time API key and AuthOS client ID to local files

Typical invocation:

authos provision act \
  --base-url https://auth.example.com \
  --act-url https://act.example.com \
  --owner-email owner@example.com \
  --owner-password '...'

Canonical docs