---
name: "glab-orbit"
section: "1"
platform: "linux"
package: "glab"
version: "1.126.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/glab-orbit"
---

# glab-orbit(1)

Query the GitLab Orbit context graph. (EXPERIMENTAL)

## NAME

glab-orbit - Query the GitLab Orbit context graph. (EXPERIMENTAL)

## SYNOPSIS

**glab orbit \[\] \[flags\]**

## DESCRIPTION

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, **--help** shows this text 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 ⟨https://docs.gitlab.com/orbit/⟩.

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

**-h**, **--help**\[=false\]\
 	Show the Orbit binary's help, or this text until the binary is installed.

**--install**\[=false\]\
 	Install the Orbit binary without running it.

**--update**\[=false\]\
 	Check for and install updates to the binary. Same as the update command.

**-y**, **--yes**\[=false\]\
 	Skip confirmation prompts.

## EXAMPLE

```
# Connect Orbit to the coding agents on this machine, or undo it
$ glab orbit setup
$ glab orbit uninstall
# Query the remote Orbit graph (authenticates automatically)
$ glab orbit status
$ glab orbit query ./query.json
$ glab orbit graph-status --full-path gitlab-org/gitlab
# Index and search a local copy of the code graph
$ glab orbit index .
$ glab orbit grep "parse config"
# Show the Orbit binary's own help and version
$ glab orbit --help
$ glab orbit version
# Install or update the managed binary without running it
$ glab orbit --install
$ glab orbit update
```

## SEE ALSO

**[glab(1)](/glab/1.md)**, **[glab-orbit-update(1)](/glab-orbit-update/1.md)**