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.

Simple modes

Mode	Who can access
private	Only the creator (and grid admins).
grid	Grid members in the listed spaces (or everyone in the grid).
link	Anyone with the URL. Optionally require sign-in or allow search 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.

The two axes (finer control)

Instead of a single mode, set the inside and outside axes directly for finer-grained control:

Axis	Values	Meaning
inside	private | spaces | grid	Who in the grid is an audience.
outside	none | link | public	Reach beyond the grid — public is anyone, findable by search engines.

# sign-in link — reachable only via the URL, not browsable inside the grid
grid visibility set my-app --inside private --outside link --require-signin

# both: also browsable by grid members
grid visibility set my-app --inside grid --outside link --require-signin

Set and inspect visibility

grid visibility show my-app
grid visibility set my-app link
grid visibility set my-app --inside grid --outside public  # search-engine discoverable
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_visibility 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.