glab(1)                                                                glab(1)



NAME
       glab-orbit-remote-status - Show GitLab Knowledge Graph cluster health.
       (EXPERIMENTAL)



SYNOPSIS
       glab orbit remote status [flags]



DESCRIPTION
       Prints the Orbit cluster health as pretty-printed JSON. Use this
       command to confirm Orbit is enabled and reachable for your user.  It is
       the first step in the Orbit discovery workflow.


       The output is always the system health object (fields such as status,
       version, components, error) regardless of the GitLab instance version.
       On newer instances (19.1+), when the backend cannot reach the gRPC
       cluster, the output includes an error field (and status is "unknown").
       Use --jq to filter health fields directly, for example --jq '.status'
       or --jq '.components'. The user/system wrapper returned by newer
       instances is not exposed in the output.


       This feature is an experiment and is not ready for production use.  It
       might be unstable or removed at any time.  For more information, see
       https://docs.gitlab.com/policy/development_stages_support/.



OPTIONS
       --hostname=""  GitLab hostname to query. Defaults to the current
       repository's host or gitlab.com.


       --jq=""   Filter JSON output with a jq expression.



OPTIONS INHERITED FROM PARENT COMMANDS
       -h, --help[=false]  Show help for this command.



EXAMPLE
       $ glab orbit remote status




SEE ALSO
       glab-orbit-remote(1)

Auto generated by spf13/cobra      Jul 2026                            glab(1)