.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH NAME
glab-orbit - GitLab Knowledge Graph commands. (EXPERIMENTAL)


.SH SYNOPSIS
\fBglab orbit [] [flags]\fP


.SH DESCRIPTION
Run the Orbit CLI for the GitLab Knowledge Graph (product name: Orbit).

.PP
Every command and flag is forwarded verbatim to the managed Orbit binary, which is downloaded, verified, and kept up to date for you on first use. \fBglab orbit remote <command>\fR authenticates automatically using your resolved GitLab credential; all other commands run the binary with no extra environment.

.PP
Prerequisites:
.IP \(bu 2
Run \fBglab auth login\fR to authenticate.
.IP \(bu 2
Orbit must be enabled for your namespace (the \fBknowledge_graph\fR feature flag).

.PP
Configuration options:
.IP \(bu 2
\fBorbit_local_auto_run\fR: Skip the run confirmation prompt.
.IP \(bu 2
\fBorbit_local_auto_download\fR: Skip the download confirmation prompt.

.PP
For more information, see the Orbit documentation
\[la]https://docs.gitlab.com/orbit/\[ra]\&.

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


.SH OPTIONS
\fB--install\fP[=false]
	Install the Orbit binary without running it.

.PP
\fB--update\fP[=false]
	Check for and install updates to the binary.

.PP
\fB-y\fP, \fB--yes\fP[=false]
	Skip confirmation prompts.


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


.SH EXAMPLE
.EX
# Guided onboarding (choose your assistant)
$ glab orbit setup claude

# Discover and query the remote Knowledge Graph (authenticates automatically)
$ glab orbit remote status
$ glab orbit remote query ./query.json
$ glab orbit remote graph-status --full-path gitlab-org/gitlab

# Index and query a local copy of the graph
$ glab orbit local index
$ glab orbit local sql "SELECT 1"

# Show the Orbit binary version
$ glab orbit version

# Install or update the managed binary without running it
$ glab orbit --install
$ glab orbit --update
.EE


.SH SEE ALSO
\fBglab(1)\fP