Skip to Content
REDCELLDocs

Sign in

Connect the RedCell CLI to your account with a browser, an API key, or on a headless machine.

RedCell needs your RedCell account to run models. Credentials are stored in ~/.redcell/auth.json.

No account yet? Sign up first.

Sign in with your browser

This is the default and works on most machines.

redcell login

Your browser opens to a consent page. Sign in and approve the request. The terminal confirms when you're signed in.

Sign in on a remote or headless machine

If you're on a server over SSH, the browser can't open there. Run redcell login on the server. It prints a URL and a local port:

Output
Starting local login server on http://localhost:PORT.
If your browser did not open, navigate to this URL to authenticate:
  1. Forward that port from your computer to the server. Replace PORT and user@server:

    ssh -L PORT:localhost:PORT user@server
  2. Open the printed URL in your local browser and approve.

Sign in with an API key

Use this for CI, scripts, or machines where a browser isn't practical.

Create a key

Create a key on the API keys page and copy it.

Pass it to RedCell through stdin

Store the key in an environment variable or secret first, then pipe it in:

printenv REDCELL_API_KEY | redcell login --with-api-key

Replace REDCELL_API_KEY with the name of the variable that holds your key.

Don't type the key directly in a command. It ends up in your shell history.

Check who's signed in

CommandShows
redcell login statusWhether you're signed in, and how
redcell whoamiYour email, name, plan, and whether CLI access is on
redcell usageYour token limit, usage, and reset date

You can also see usage and your plan on the dashboard.

Sign out

redcell logout

This revokes the CLI token on the server and removes your local credentials. Inside a session, /logout does the same and exits.

Troubleshooting

ProblemFix
CLI access: false in redcell whoamiYour plan doesn't include CLI access. Compare plans or manage billing.
Out of quotaCheck redcell usage. Wait for the reset date or upgrade your plan.
A key stopped workingIt may have been revoked. Create a new one on the API keys page.
Browser never opensCopy the printed URL into your browser manually.