Orientation

Install and Authenticate

npm install -g @cloudgrid-io/cli

The CLI verb is grid (the old cloudgrid, gridctl, and cg names are deprecated).

Verify the installation:

cloudgrid --version
grid doctor

grid doctor runs diagnostic checks: Node.js version, Docker availability, CLI config, API reachability, and authentication status.

grid login

This opens a browser window for Google OAuth. After authenticating, the CLI stores credentials at ~/.cloudgrid/credentials.

To authenticate without a browser (e.g., in SSH or CI):

grid login --no-browser

This prints a URL to visit manually, then waits for the token.

grid whoami

Shows your email, active org, and org memberships. Use --json for machine-readable output.

grid use <org-slug>

Sets the active org for all subsequent commands. Omit the slug to see the current selection.