Skip to main content
Version: v5.7.0

opschain git-remotes show

Included from Basic tier

opschain git-remotes show <project>/<name>

Shows one Git remote: its URL, display (public) URL, archived/disabled state, periodic fetch interval, the periodic fetch sweep's record (last_fetched_at, last_fetch_outcome — ok, failed or skipped, last_fetch_error — the credential-free cause of the last failure, consecutive_failures, next_fetch_at — when the remote is next due, floating_versions — the floating template versions the sweep repins on it, last_repin_at), the ref-move watch (watch_default_branch — whether the default branch records info:git_remote:ref_moved unprompted, and last_ref_move_at — when a watched ref last moved; git-remotes refs lists the watched refs), the shared credential reference, timestamps, and each credential reported as set or unset. The server never returns a stored credential's value — a set credential comes back as a masked placeholder, which this command renders as set (masked); an unset one renders as -. opschain docs resources/git_remote ("The periodic fetch") explains the sweep and the effective interval.

The remote is resolved by name through the project's remotes index, so the positional argument is always <project>/<name>, never an id.

Output​

name: origin
id: 0199a2c4-…
project: demo
url: https://github.com/acme/demo-config.git
public_url: -
archived: false
disabled: false
fetch_interval: 300
last_fetched_at: 2026-10-01T03:20:00Z
last_fetch_outcome: ok
last_fetch_error: -
consecutive_failures: 0
next_fetch_at: 2026-10-01T03:25:00Z
floating_versions: 1
last_repin_at: 2026-10-01T03:20:01Z
watch_default_branch: true
last_ref_move_at: 2026-10-01T03:20:00Z
credential_ref: -
credentials (stored values are never returned by the server):
user: set (masked)
password: set (masked)
passphrase: -
ssh_key: -
created_at: 2026-10-01T03:12:45Z
updated_at: 2026-10-01T03:12:45Z

-o json|yaml prints the resource document instead.

Exit codes​

CodeMeaning
0Shown.
1The remote or project was not found, or the request failed.
2Usage error — malformed address, no server target.

Named errors​

  • expected <project>/<git-remote-name>, got "<arg>" — the positional argument has no slash or an empty half (exit 2).
  • git remote "<name>" not found in project "<project>" — exit 1.
  • git remotes live on a server's projects — pass --server <url> or 'opschain context use <name>' — no server target (exit 2).

See also​

  • opschain docs cli/git-remotes-list — every remote at a glance.
  • opschain docs cli/git-remotes-update — change what this shows.