Reference

CLI Command Cheat Sheet

Authentication

Command	What it does
`grid login`	Authenticate via Google OAuth
`grid login --no-browser`	Auth without opening a browser
`grid login --token <jwt>`	Auth with an existing token
`grid logout`	Sign out and clear credentials
`grid whoami`	Show current user and orgs
`grid use <slug>`	Set active org

Core Lifecycle

Command	What it does
`grid init <kind> <name> --type <T>`	Create entity and scaffold files
`grid plug`	Build and deploy (or redeploy)
`grid plug <file>`	Upload a file as an inspiration
`grid unplug [<name>]`	Take entity off the grid
`grid unplug --dark`	Reversible power-down
`grid unplug --hard`	Immediate removal
`grid status`	Status-grouped dashboard
`grid dev`	Run locally with grid services

Entity Operations

Command	What it does
`grid status [<name>]`	Entity or org dashboard
`grid info [<name>]`	Detailed entity metadata
`grid open [<name>]`	Open entity URL in browser
`grid open --print`	Print URL instead
`grid logs [<name>]`	Stream entity logs
`grid logs --follow`	Real-time log streaming
`grid builds [<name>]`	List recent deploys
`grid follow <trace_id>`	Re-attach to a deploy
`grid ssh [<name>]`	Interactive shell in pod
`grid call <to> <path>`	Debug cross-app calls

Entity Mutation

Command	What it does
`grid rollback [<name>]`	Roll back to previous deploy
`grid versions list`	List version snapshots
`grid versions tag <id> <label>`	Tag a version
`grid versions pin <id>`	Pin version (prevent cleanup)
`grid pull [<name>]`	Download source from last deploy
`grid clone <name>`	Download source + yaml + link
`grid fork <source>`	Create a new entity from existing
`grid rename <slug> <name>`	Change display name
`grid delete <slug>`	Archive an inspiration
`grid visibility set <slug> <mode>`	Change visibility

Configuration

Command	What it does
`grid env list [<name>]`	List env vars
`grid env set <name> KEY=val`	Set env vars (triggers restart)
`grid env unset <name> KEY`	Remove env var
`grid secrets list [<name>]`	List secret keys
`grid secrets set <name> KEY=val`	Set secrets
`grid secrets unset <name> KEY`	Remove secret

Source and Deployment

Command	What it does
`grid wire repo <url>`	Bind GitHub repo for auto-deploy
`grid wire repo --remove`	Unbind repo
`grid scaffold`	Re-scaffold from cloudgrid.yaml
`grid scaffold service <name> --type <T>`	Add a new service
`grid scaffold rename <old> <new>`	Rename a service
`grid scaffold env-example`	Generate .env.example

Team Management

Command	What it does
`grid admin invite <email>`	Invite user to org
`grid admin members`	List org members
`grid admin member-role <email> <role>`	Change role
`grid admin remove <email>`	Remove member
`grid admin invitations`	List pending invitations
`grid admin revoke <email>`	Revoke invitation

Spaces

Command	What it does
`grid space list`	List spaces
`grid space create <slug> --name <N>`	Create space
`grid space show <slug>`	Show space details
`grid space members <slug>`	List space members
`grid space invite <slug> <email>`	Add member to space
`grid space remove <slug> <email>`	Remove from space
`grid space archive <slug>`	Archive space

Dev Sandbox

Command	What it does
`grid dev`	Start all services locally
`grid dev <service>`	Start one service
`grid dev -- <cmd>`	Custom command with grid env
`grid dev --status`	Check running session
`grid dev --kill`	Stop stale session
`grid dev seed`	Seed dev database
`grid dev seed --from ai`	AI-generated seed data
`grid dev reset`	Reset dev database

Utilities

Command	What it does
`grid doctor`	Run diagnostic checks
`grid feedback [<text>]`	Submit feedback
`grid link repair`	Fix stale link.json
`grid brain refresh <slug>`	Re-run AI brain
`grid hooks add <event> <url>`	Add webhook
`grid hooks list`	List hooks
`grid hooks deliveries`	View delivery log
`grid completion <shell>`	Shell completion (bash/zsh/fish)