Authenticate the CLI

Authenticate the CLI so platform commands can access your workspace.

Log in

Run easel login to open a browser session against app.easel.sh. After you approve access, the CLI saves a token locally and prints the signed-in user and active workspace.

easel login
easel whoami

Tokens created by login include deploy permissions (deployments:create, files:write). If you logged in before those scopes existed, run easel logout && easel login once.

Token resolution

Token resolution order is:

1. --token / -t on the command line
2. The EASEL_TOKEN environment variable
3. The token saved by easel login

For CI or non-interactive shells, set EASEL_TOKEN instead of using browser login:

export EASEL_TOKEN="your_access_token_here"
easel whoami --format json

Log out

Remove saved credentials with:

easel logout

Next steps