Orientation

Key Concepts

Entity. The universal unit. Every inspiration, app, and agent is an Entity with a different realm and kind.

Plug. The verb for putting something on the grid. grid plug builds, deploys, and goes live. Idempotent — re-running it updates the entity in place.

Unplug. The verb for taking something off the grid. grid unplug powers down or removes an entity.

Charged. An entity that has been created on the server but not yet deployed. Produced by grid init. Transitions to running on first plug.

Running (live). An entity that is actively serving traffic.

Org. An organization. Every entity belongs to one org. Every user can belong to multiple orgs.

Space. A grouping context within an org — like a Slack channel. Entities can be scoped to a space for discovery.

Brain. A post-deploy AI job that auto-generates description, icon, category, and tech stack for an entity.

Link file. .cloudgrid/link.json — a gitignored file that binds a local directory to a server-side entity. Created automatically by init or plug.