Skip to main content
Authenticate the CLI with your Basecut account using the OAuth2 device authorization flow. This will open a browser window for you to sign in. Once complete, your credentials are saved to a local profile.
basecut login requires an interactive terminal to open the browser and poll for the authentication token.

​
Usage

​
Flags

​
Optional

​
Examples

​
Quick Start

​
Standard Interactive Login

Most common usage to get started:
What happens:
  1. The CLI generates a unique device code.
  2. It attempts to open your default web browser to the Basecut login page.
  3. You sign in via the browser.
  4. The CLI polls the API until the authorization is confirmed.
  5. Success credentials are stored in ~/.basecut/credentials.

​
Machine-to-Machine / Headless Login

For environments without a browser (like SSH sessions), Basecut will print a URL for you to copy-paste:
If a browser can’t be opened, you’ll see:

​
Environment Variables

​
Success Output

​
Next Steps

Check Status

Verify your current login status and plan

Log Out

Remove stored credentials