Collaboration
For the conceptual difference between these verbs, see Plug, pickup, and pull.
grid pickup
Section titled “grid pickup”Make your own copy of an entity — a new, independent entity in your grid
with lineage back to the original. The copy is minted without the source’s
secrets (set your own before you plug). After the copy is minted, its source
is downloaded and the folder is linked so your next grid plug deploys the copy.
grid pickup <id|grid/slug> [dir]| Argument | Description |
|---|---|
id|grid/slug |
App URL, id, or grid/slug to copy. |
dir |
Directory to lay the copy into. Defaults to the app name. |
| Option | Description |
|---|---|
--into-org <slug> |
Grid to create your copy in (required when you belong to multiple grids). |
--name <slug> |
Slug for your copy. Defaults to the source name plus a suffix. |
--version <id> |
Copy an older version of the source instead of HEAD. |
--force |
Lay the copy into a non-empty directory. |
--no-bind |
Create the copy only — skip the source download and link. |
--copy |
Confirm the copy without prompting. |
--claim-token <token> |
Claim an anonymous drop — transfers ownership of that entity to you instead of copying. |
--json |
Print the result as JSON. |
grid pull
Section titled “grid pull”Download an existing entity’s source, write a cloudgrid.yaml, and link the
folder so your next grid plug updates the same entity in place. Use it to
take over or collaborate on an existing entity. Requires push access — you
must own it or be a collaborator.
grid pull <name> [target-dir]| Argument | Description |
|---|---|
name |
Entity slug, UUID, or grid/slug. |
target-dir |
Local directory to download into. Defaults to ./<slug>. |
| Option | Description |
|---|---|
--no-bind |
Record the grant only; skip the local download. |
--grid <slug> |
Grid override. |
--force |
Overwrite a non-empty target directory. |
--version <id> |
Pull an older version instead of the latest. |
--json |
Raw JSON response. |
grid link
Section titled “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.jsongrid rename
Section titled “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>