glab(1)

📦
version 1.114.0 · 3 versions
, in epel 10, epel 9, fedora 44, opensuse-leap 16.0

✨ NAME ✨

okay bestie, this is the manual page for glab(1) — and the star of this specific show is glab-orbit-remote-status — Show GitLab Knowledge Graph cluster health. 🩺💖

(EXPERIMENTAL) — yes, that's in the actual name, she's wearing a little "still cooking" badge and we respect it. 🙈

🌈 SYNOPSIS 🌈

glab orbit remote status [flags]

🩷 DESCRIPTION 🩷

So what does she do? She prints the Orbit cluster health as pretty-printed JSON. That's it, that's the whole gig. 🎀

Use this command to confirm Orbit is enabled and reachable for your user. It is literally the first step in the Orbit discovery workflow, so think of it as the vibe check before the rest of the journey. ✨

The output is always the system health object — fields such as status, version, components, error — regardless of the GitLab instance version. No cap, same shape every time.

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'. Obsessed with a good one-liner filter fr fr. 💅

Heads up though: the user/system wrapper returned by newer instances is not exposed in the output. She keeps that part hidden, main character mystery energy. 👑

🚨 EXPERIMENTAL ALERT 🚨 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/. Do not build your whole life on it, bestie, she could ghost at any moment. 💀

💖 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. The classic, the icon, the one you hit when everything is on fire. 🫶

🎀 EXAMPLE 🎀

$ glab orbit remote status

🌟 SEE ALSO 🌟

and that's the whole page, bestie!! 🧚 Auto generated by spf13/cobra, Aug 2026, glab(1) — mwah, slay, go check your cluster health 💜🍓

📦 where this page comes from