glab orbit

Query the GitLab Orbit context graph. (EXPERIMENTAL)

Synopsis

Run the GitLab Orbit CLI through glab.

Coding agents: run glab orbit --yes skills get orbit to load the Orbit skill. --yes installs the binary without a prompt on first use.

Every command and flag, including --help, is forwarded verbatim to the managed Orbit binary. glab downloads, verifies, and updates that binary for you on first use. Until the binary is installed, glab orbit and --help print install instructions instead. glab passes your resolved GitLab credential to the binary on every invocation, so remote commands such as glab orbit query need no separate login.

glab handles only the update command and the --install, --update, and --yes flags itself. Run glab help orbit to see them.

Prerequisites:

  • Run glab auth login to authenticate.
  • Orbit must be enabled for your namespace (the knowledge_graph feature flag).

Configuration options:

  • orbit_cli_auto_run: Skip the run confirmation prompt.
  • orbit_cli_auto_download: Skip the download confirmation prompt.

For more information, see the Orbit documentation.

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/.

glab orbit [<command>] [flags]

Examples

console
# Install the managed binary without running it, or update it
$ glab orbit --install --yes
$ glab orbit update

# Install on first use without a prompt, then load the Orbit skill
$ glab orbit --yes skills get orbit

# Show the Orbit binary's own help
$ glab orbit --help

Environment variables

- `GLAB_ORBIT_CLI_BINARY_PATH`: Use a local binary instead of the managed one. Skips
  download, version checks, and updates. Can also be set via the `orbit_cli_binary_path`
  configuration key.
- `ORBIT_CLI_AUTO_DOWNLOAD`: Set to `true` to download the binary without a
  prompt. Required to run in a non-interactive environment such as CI.
- `ORBIT_CLI_AUTO_RUN`: Set to `true` to run the binary without a prompt.
  Required to run in a non-interactive environment such as CI.

Options

  -h, --help      Show the Orbit binary's help, or install instructions until the binary is installed.
      --install   Install the Orbit binary without running it.
      --update    Check for and install updates to the binary. Same as the update command.
  -y, --yes       Skip confirmation prompts.

Subcommands