Auth

The auth command group manages authentication for the CLI. Your API key is stored locally at ~/.reddgrow/config.json and reused across all subsequent commands.

Commands

login

Save an API key to the local config file.

reddgrow auth login <key>

Arguments

Example

reddgrow auth login rg_your_key_here

The key is written to ~/.reddgrow/config.json. Any previously saved key is overwritten.

whoami

Show the identity associated with the current API key and your remaining credit balance.

reddgrow auth whoami

Credit cost: 1 credit

Example

reddgrow auth whoami
# Account: you@example.com
# Credits remaining: 4,820

status

Check whether the CLI can reach the ReddGrow API with the current key, without consuming data credits.

reddgrow auth status

Useful for debugging connection issues or verifying that environment variable overrides are wired up correctly.

Example

reddgrow auth status
# Connected — api.reddgrow.ai

logout

Remove the saved API key from the local config file.

reddgrow auth logout

This deletes the key from ~/.reddgrow/config.json. The file itself is kept. If REDDGROW_API_KEY is set as an environment variable it will still be used after logout — unset it separately if needed.

Example

reddgrow auth logout
# API key removed.

Key Precedence

If both a saved key and an environment variable are present, the environment variable takes priority. See Configuration for full precedence rules.