Visibility and sharing

Visibility controls who can access an entity. Changing it never changes the URL — the URL is stable for the life of the entity.

Modes

Mode	Who can access
private	Only the creator (and grid admins).
authenticated	Any signed-in CloudGrid user.
grid	Grid members in the listed spaces (or everyone in the grid).
link	Anyone with the URL. Optionally indexed for discovery.

Note

The realm shapes which modes are most useful. Inspirations are commonly set to link to share a page with someone outside the grid. Apps most often stay grid (internal) unless you deliberately open them up.

Set and inspect visibility

grid visibility show my-app
grid visibility set my-app link
grid visibility set my-app link --indexed      # allow discovery in the grid
grid visibility set my-app private

Scope grid visibility to specific spaces:

grid visibility set my-app grid --space engineering --space design
grid visibility add-space my-app marketing
grid visibility remove-space my-app design

Sharing a link

1. Set visibility to link:

   grid visibility set my-app link

2. Get the URL:

   grid open my-app --print
   # https://my-app.your-grid.cloudgrid.io

3. Send it. With link visibility, no account is needed to open it.

From an AI assistant

The MCP tools grid_set_sharing and grid_share change visibility from a chat, and default their target to the thing you just published — so “make it private” needs no ids.