opschain git-remotes
Included from Basic tier
Manages a project's Git remotes: the repositories its changes and templates
build from. Remotes live on the server (/api/projects/{code}/git_remotes)
— there is no local form, so every subcommand needs a server target
(--server <url>, OPSCHAIN_SERVER or the active opschain context).
A remote is addressed as <project>/<name>; the name is unique within its
project.
A remote authenticates through a shared credential reference
(--credential-ref <id|name> on create/update, naming an entry of
opschain git-credentials — rotated once for every referencing remote)
or through inline credentials, never both. Inline credentials are
write-only: a password or token enters through an environment variable or
a no-echo prompt, an SSH key through a file, and the server stores them
encrypted and never returns their values — list and show report each
credential only as set or unset (AUTH reads shared-credential for a
referencing remote).
| Subcommand | Does | Manual |
|---|---|---|
list <project> | List a project's remotes | opschain docs cli/git-remotes-list |
show <project>/<name> | Show one remote, credentials as set/unset | opschain docs cli/git-remotes-show |
create <project> | Create a remote (attributes + credential flags) | opschain docs cli/git-remotes-create |
update <project>/<name> | Patch attributes, replace credentials | opschain docs cli/git-remotes-update |
delete <project>/<name> | Delete (preview without --confirm) | opschain docs cli/git-remotes-delete |
refs <project>/<name> | The watched refs at their last-fetched tips, with their last move | opschain docs cli/git-remotes-refs |
fetch <project>/<name> | Fetch the remote now (ref moves recorded, floating versions repinned) | opschain docs cli/git-remotes-fetch |
See also
opschain docs cli/git-credentials— the shared credential registry remotes reference.opschain docs cli/templates— templates pin their versions to revisions of these remotes.opschain learn 3.3— the guided tour of Git remotes and templates.