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 loginYour 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:
Starting local login server on http://localhost:PORT.
If your browser did not open, navigate to this URL to authenticate:-
Forward that port from your computer to the server. Replace
PORTanduser@server:ssh -L PORT:localhost:PORT user@server -
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-keyReplace 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
| Command | Shows |
|---|---|
redcell login status | Whether you're signed in, and how |
redcell whoami | Your email, name, plan, and whether CLI access is on |
redcell usage | Your token limit, usage, and reset date |
You can also see usage and your plan on the dashboard.
Sign out
redcell logoutThis revokes the CLI token on the server and removes your local credentials. Inside a session, /logout does the same and exits.
Troubleshooting
| Problem | Fix |
|---|---|
CLI access: false in redcell whoami | Your plan doesn't include CLI access. Compare plans or manage billing. |
| Out of quota | Check redcell usage. Wait for the reset date or upgrade your plan. |
| A key stopped working | It may have been revoked. Create a new one on the API keys page. |
| Browser never opens | Copy the printed URL into your browser manually. |