opschain git-remotes refs

Included from Basic tier

opschain git-remotes refs <project>/<name> [--filter <col>=<value>]...

Prints the remote's ref snapshot: the refs the periodic fetch watches for moves — the default branch (unless the remote's watch_default_branch is off), the refs floating template versions follow and the refs enabled triggers name — each at the commit the platform last observed, with the last recorded move (fast_forward, forced, created, deleted) and when it was seen. The snapshot is what info:git_remote:ref_moved events are judged against (opschain docs resources/git_remote, "Ref-move events"); it is empty until the remote's first fetch after the ref-move lane was switched on, and a ref a new trigger names appears on the remote's next fetch.

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

Output

REF                  KIND    SHA                                       OBSERVED              LAST CHANGE   LAST MOVED
refs/heads/main      branch  4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d  2026-10-01T03:20:00Z  fast_forward  2026-10-01T03:20:00Z
refs/tags/v1.2.0     tag     0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b  2026-10-01T03:20:00Z  -             -

- in LAST CHANGE / LAST MOVED means the ref has not moved since it was first watched. -o json|yaml prints the rows as documents (ref, sha, kind, observed_at, last_change, last_moved_at).

Flags

Flag	Meaning
--filter <column>[!]=<value>	Keep only rows matching the term (repeatable; terms AND). Columns are the printed table headers lowercased (spaces fold to _: ref, kind, sha, observed, last_change, last_moved); * wildcards, != negates, commas mean any-of. Applied client-side. Grammar: opschain docs cli.

Exit codes

Code	Meaning
0	Printed (an empty snapshot prints no watched refs recorded yet (the snapshot fills on the remote's next fetch)).
1	The remote was not found, or the server refused the read.
2	Usage error — malformed address, no server target.

See also

• opschain docs cli/git-remotes-show — the remote's fetch record, watch_default_branch and last_ref_move_at.
• opschain docs triggers ("The git ref-move source") — firing a workflow when a watched ref moves.