Orientation
What is CloudGrid
CloudGrid is an internal runtime for AI-built work. It runs on GKE and lets anyone on a team — marketer, PM, engineer, AI agent — ship work into the org’s shared infrastructure. Databases (MongoDB, Redis), an AI gateway, secrets, cron, SSL, and org-wide auth are wired in by default.
One command to deploy. One place to discover.
Two Realms
Everything on the grid belongs to one of two realms:
| Realm | What it holds | URL shape | Lifecycle |
|---|---|---|---|
| Inspirations | Static content: decks, docs, HTML demos, Claude artifacts, PDFs | <org>.cloudgrid.io/<slug> (path-based) | Ephemeral (30-day default) |
| Runtimes | Running services: apps and agents | <slug>.<org>.cloudgrid.io (subdomain) | Persistent |
Three Tiers
All tiers live in one unified entity registry. Graduation between tiers is a metadata change, not a migration. URL is preserved. History is preserved.
| Tier | What | Who |
|---|---|---|
| Inspiration | A static file dropped onto the grid | Anyone (drag-drop, CLI, MCP) |
| App | A multi-service deployment defined by cloudgrid.yaml | Engineers, technical PMs |
| Agent | An app with an agent: block (schedule, memory, purpose, budget) | Anyone via template |