Collaboration

For the conceptual difference between these verbs, see Plug, pickup, and fork.

grid pickup

Download an entity’s source, write a cloudgrid.yaml, and link the folder to the entity. Use it to take over or collaborate on an existing entity.

grid pickup <name> [target-dir]

Argument	Description
name	Entity slug, UUID, or org/slug.
target-dir	Local directory to download into. Defaults to ./<slug>.

Option	Description
--no-bind	Record the grant only; skip the local download.
--claim-token <token>	Claim an anonymous (Guest-Grid) drop using its claim link/token — after which you own it and it stops expiring on the anonymous schedule. There is no standalone grid claim; claiming is done here.
--grid <slug>	Grid override.
--force	Overwrite a non-empty target directory.
--version <id>	Pick up an older version instead of the latest.
--json	Raw JSON response.

grid fork

Create a new owned copy of an entity in your grid, with lineage back to the original.

grid fork <id|org/slug|url>

Option	Description
--into-org <slug>	Destination grid (required when you belong to multiple grids).
--name <slug>	Override the new entity’s slug.
--version <id>	Fork from an older version.
--json	Raw JSON response.

fork creates a new, independent entity with its own identity and URL. pickup gives you access to the same entity.

grid remix

Make your own copy of an app you can see, into a grid you can build in. Unlike fork (which is same-grid and carries the source bytes), remix is the cross-grid “copy this into my grid” verb: it mints a new entity in the charged state with lineage recorded back to the source, minus the source’s secrets.

grid remix <id|grid/slug> [dir]

Argument	Description
id|grid/slug	The source app to remix.
dir	Local directory to bind the copy into. Defaults to ./<slug>.

Option	Description
--into-org <slug>	Destination grid (required when you belong to multiple grids).
--name <slug>	Override the new entity’s slug.
--version <id>	Remix from an older version.
--force	Overwrite a non-empty target directory.
--no-bind	Record the copy only; skip the local download.
--json	Raw JSON response.

Use fork to branch within the same grid (byte-for-byte, lineage kept); use remix to take a copy into a different grid you own (secrets dropped).

grid download

Download the source bundle from the last deploy. Extracts source into <name>/services/<service>/.

grid download [name]

Argument	Description
name	Entity slug or UUID. Defaults to the linked entity.

grid link

Bind the current folder to an existing grid entity without downloading code. An alias of grid wire folder.

grid link [entity]

Repair a stale binding:

grid link repair [--dry-run]   # fix a stale org_slug in link.json

grid rename

Change the display name of an entity. The slug (and URL) stays the same. Works for both runtimes and inspirations.

grid rename <slug> <new-display-name>