Skip to main content
Version: v5.7.0

opschain git-remotes list

Included from Basic tier

opschain git-remotes list <project> [--wide]

Lists the project's Git remotes as a table. Stored credentials never appear as values — the AUTH column names only the credential shape each remote carries, derived from which credentials are set: ssh-key+passphrase, ssh-key, password, user-only or none.

Columns: NAME, URL, AUTH, ARCHIVED, LAST FETCH, OUTCOME, FAILURES, CREATED. The three fetch columns are the server's periodic fetch sweep's record on the remote: when it last fetched the remote (- until the first sweep), how that went (ok, failed or skipped) and how many periodic fetches in a row have failed (0 after a success) — see opschain docs resources/git_remote, "The periodic fetch". A project with no remotes prints no git remotes.

Flags​

FlagMeaning
--wideAdd the PUBLIC URL, FETCH INTERVAL, NEXT FETCH (when the remote is next due; - while archived, disabled or never fetched) and FLOATING (the unarchived floating template versions the sweep repins on the remote) columns (- where unset).
--filter <column>[!]=<value>Keep only rows matching the term (repeatable; terms AND). Columns are the printed table headers lowercased (spaces/dashes fold to _); * wildcards match the whole cell case-insensitively, != negates, commas mean any-of. Applied client-side. Grammar: opschain docs cli.

-o json|yaml prints the full resource documents instead of the table — credential fields come back as the server sent them: a masked placeholder when set, null when unset.

Exit codes​

CodeMeaning
0Listed (including an empty list).
1The request failed (unknown project, network, auth).
2Usage error — no server target, wrong arguments.

Named errors​

  • git remotes live on a server's projects — pass --server <url> or 'opschain context use <name>' — the command ran without a server target (exit 2).

Examples​

opschain git-remotes list demo
opschain git-remotes list demo --wide -o json

See also​

  • opschain docs cli/git-remotes-show — one remote in full.
  • opschain docs cli/git-remotes-create — add a remote.