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 an organization token and save it in the global Redo config.

> Redo Page
✓ Logged in to My Company
ℹ Auth saved globally

Next steps:
  redo init
  redo whoami

Check Your Auth Status

View your current authentication configuration:

redo auth status

Output shows your configuration and connected sites:

> Redo Page

Account
  Logged in: yes
  Organizations:
    * My Company (org_abc123)  https://redopage.com

Project
  Config: /path/to/my-site/.redo/config.json
  Site: Coffee Shop
  Auth: available

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 remote site. To work on it from the current folder, run redo init.

Link This Folder

redo init
redo init --site site_abc123

redo init writes .redo/config.json with the org and site identity. It does not write an auth token into the project folder.

Tokens

Use redo login to save org auth globally. Project folders should contain only a site link, not a token.

Keep tokens secure

Never commit tokens to version control. If a project folder moves to a new machine, run redo login again instead of copying tokens.

Log Out

redo logout
redo logout --org org_abc123
redo logout --all

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 project configuration. The CLI uses the nearest project config from the current folder or a parent folder.

Configuration Precedence

Command flags - --site, --org, and --api override defaults
Project config - nearest .redo/config.json with "kind": "project"
Global auth - saved by redo login

Token Types

Token Prefix	Scope	Use Case
`rdk_org_`	Organization	Access all sites in your org (from `redo login`)
`rdk_site_`	Single site	Legacy/manual integrations only

Next: Content Management →