Skip to content

Authentication

Sign in via Google OAuth. Opens a browser-based device flow. The token is stored at ~/.cloudgrid/credentials.

Terminal window
grid login
Option Description
--no-browser Manual code-entry mode (for headless environments).
--token <jwt> Provide a JWT directly (for testing).
--no-telemetry Opt out of anonymous usage telemetry.

Sign out and clear local credentials. Clears ~/.cloudgrid/credentials and the active grid setting.

Terminal window
grid logout

Show the current user and active grid: name, email, slug, active grid, and all grid memberships.

Terminal window
grid whoami
Option Description
--json Machine-readable JSON output.
-o, --output <format> Output format.

Set the active grid for subsequent commands.

Terminal window
grid use [slug]
Argument Description
slug Grid slug to switch to. If omitted, shows the current active grid.
Terminal window
grid use # show the active grid
grid use my-company # switch to the my-company grid