CLI Authentication

Set up authentication to connect the CLI to your Redo account.

Browser Login (Recommended)

The easiest way to authenticate is with browser login:

redo login

This opens your default browser to the Redo login page. Sign in with your account, and the CLI will automatically receive your credentials.

Opening browser to authenticate...
✓ Logged in as yourname@company.com
✓ Org token saved to ~/.redo/config.json

Check Your Auth Status

View your current authentication configuration:

redo auth status

Output shows your configuration and connected sites:

Config: ~/.redo/config.json
API URL: https://api.redopage.com
Org: My Company ✓
Default site: site_abc123

Configured sites:
ID                  NAME              DEFAULT
────────────────────────────────────────────────────
site_abc123         Coffee Shop       ✓
site_def456         Portfolio

Site Management

List Available Sites

redo site list

Shows all sites in your organization that you have access to.

Create a New Site

# Create a site with auto-generated name
redo site create

# Create with a specific name
redo site create "My New Site"

This creates a new site and optionally initializes a local project folder.

Switch Default Site

redo use site_abc123

Sets the default site for subsequent commands. You can always override with --site:

redo list pages --site site_def456

Manual Token Setup

For CI/CD pipelines or automation, you can add tokens directly:

# Add a site token
redo auth add rdk_site_xxxxx --site site_abc123

# Add with a friendly name
redo auth add rdk_site_xxxxx --site site_abc123 --name "Production Site"

Remove a Site

redo auth remove site_abc123

Project Configuration

Create a project-specific config by running redo init in your project directory:

cd my-project
redo init

This creates a .redo/ folder with local configuration. The CLI automatically uses local config when present, falling back to global config.

Configuration Precedence

1. Command flags - --site, --api override everything
2. Local config - .redo/config.json in current or parent directory
3. Global config - ~/.redo/config.json

Token Types

Token Prefix	Scope	Use Case
rdk_org_	Organization	Access all sites in your org (from redo login)
rdk_site_	Single site	Limited access for CI/CD or specific projects

Next: Content Management →