cxgrdcxgrd docs

cxgrd auth

Authentication commands for Pro, Team, and Enterprise users.

Usage

cxgrd auth login     # sign in via GitHub OAuth
cxgrd auth logout    # sign out and remove local token
cxgrd auth status    # show current account and plan

Login

cxgrd auth login

Opens a GitHub OAuth flow in your browser. After authorizing, the CLI picks up the session automatically and saves a JWT to ~/.cg/auth.json.

$ cxgrd auth login
✓ Opening browser for GitHub sign-in...
   Session: d83*****...
   If the browser does not open: https://cxgrd.com/auth/cli?session=d8349e...

   Waiting for authorization...

✓ Signed in successfully
   Token saved to /Users/name/.cg/auth.json
   Plan: team

You'll be asked to authorize CXGRD to access your GitHub account for authentication only. CXGRD does not read your code or repositories via OAuth.

What happens after login

  1. GitHub OAuth completes in your browser
  2. A signed JWT is issued and saved to ~/.cg/auth.json
  3. The CLI picks up the token automatically on every command
  4. Pro/Team features are unlocked based on your plan

Token storage

The JWT and account details are stored at ~/.cg/auth.json on your machine. The token expires after 30 days — run cxgrd auth login again to refresh it.

CI tokens

For GitHub Actions and other CI environments, use a CI token instead of your login token. CI tokens never expire and can be generated from your team dashboard under CI Setup.

See cxgrd check --ci for the full CI setup guide.

Upgrade at https://cxgrd.com/pricing