aura login

Authenticate with an OAuth provider.

Syntax

aura login <provider> [flags]

Description

Runs a device code flow to authenticate with copilot or codex. The resulting token is stored in ~/.aura/auth/ (global) or --config/auth/ (local, with --local).

Supported Providers

Provider	Token Type	Description
copilot	GitHub OAuth (ghu_...)	GitHub Copilot subscription
codex	OpenAI refresh token (rt_...)	ChatGPT Plus/Pro subscription

Flags

Flag	Default	Description
--local	false	Save token to project config instead of global ~/.aura/auth/

Plus all global flags.

Examples

# Authenticate with GitHub Copilot
aura login copilot

# Authenticate with OpenAI Codex
aura login codex

# Save token to project-local config
aura login --local codex

Tokens can also be set via environment variables (AURA_PROVIDERS_COPILOT_TOKEN, AURA_PROVIDERS_CODEX_TOKEN) or in the provider YAML config.