gram auth

The auth command authenticates with the Gram platform by opening a browser window for login. After successful authentication, it creates and saves a Producer API key to the local profile configuration.

The gram auth command is typically run once during initial setup. The created API key and profile information are stored in ~/.gram/profile.json.

Usage

Authenticate with Gram:


gram auth

This command will:

Open a browser window to the Gram authentication page
Prompt for login credentials
Create a Producer API key in the Gram dashboard
Save the API key and profile information locally

After authentication, verify the setup with gram whoami.

Options

`api-url`

The URL of the Gram web application. This option is useful for connecting to custom or self-hosted Gram instances.


gram auth --api-url https://custom.gram.instance [other options]

Can also be set via the GRAM_API_URL environment variable.

Last updated on September 16, 2025