CLI setup

Install the Authalla CLI and agent skill to configure your tenant from the command line.

Install the CLI

The CLI is available via Homebrew:

brew tap authalla/tap
brew install authalla

Log in

Authenticate with your Authalla account using the login command. This opens your browser where you sign in with your existing credentials (passkey, magic link, etc.) — no API keys or secrets needed.

authalla login

Discovering OIDC endpoints...
Opening browser to authenticate...
Waiting for callback on http://localhost:63352/callback

✓ Logged in as jane@example.com
Active account: My Company
Active tenant: production (lnviblxvycjbe3ffq1ssg)

The CLI uses standard OAuth2 Authorization Code with PKCE. Your session is stored locally and tokens are refreshed automatically.

If you have access to multiple accounts, the CLI will prompt you to select one:

You have access to 2 accounts:
  1. Acme Corp (acme-corp)
  2. Personal (personal-123)

Select account [1]:

Switch accounts and tenants

If you manage multiple accounts or tenants, you can switch between them without logging in again:

# List your accounts
authalla accounts list

# Switch to a different account
authalla accounts select <account-id>

Verify your session

Check your current authentication status and active tenant:

authalla config show

Log out

Clear your stored tokens:

authalla logout

M2M credentials (for CI/CD)

For automated pipelines and scripts where browser login isn't possible, you can use machine-to-machine client credentials instead. Create a Backend Service client in the Admin UI, then configure the CLI:

authalla config set \
  --api-url https://your-tenant.authalla.com \
  --client-id your_client_id \
  --client-secret your_client_secret

Add the agent skill

The Authalla agent skill lets your AI coding assistant handle tenant configuration for you — branding, custom domains, email setup, social login, and OAuth2 client creation.

npx skills add authalla/agent-skills

Once installed, invoke the skill from your AI agent (e.g. Claude Code) and it will walk you through the full tenant setup interactively.

Available CLI commands

Run authalla <command> --help for details on any command.