Skip to content

ci.status

Say where the head commit's runs stand; exit that state's code.

Green exits 0, red 13, pending 18, a wait that runs out 14, and a forge unreachable for five polls in a row under the wait 15, so a script can ask whether main's push has finished after a merge. The head is the pull request's when the branch has one, else the local HEAD, so on main after a pull it is the merge. --point=nightly reads the newest nightly run instead, by workflow rather than by commit, so a failure only the nightly meets reaches a person here.

fm ci.status [--wait] [--interval=INT] [--timeout=INT] [--point=VALUE]
Parameter Type Default Description
--wait flag false poll until the runs are no longer pending
--interval=INT int 15 poll seconds under --wait
--timeout=INT int 1800 deadline seconds under --wait
--point=VALUE "" read the newest run of this point instead

Example

$ fm ci.status --wait