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

.SH NAME
glab-orbit-setup - Guided setup for Orbit: verify access, install the skill, install the local CLI. (EXPERIMENTAL)


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


.SH DESCRIPTION
Run a guided onboarding for the GitLab Knowledge Graph (Orbit):
.IP "  1." 5
Verify that Orbit is reachable and enabled for your user.
.IP "  2." 5
Install the Orbit agent skill so AI coding agents can discover it.
.IP "  3." 5
Install the Orbit local CLI binary for indexing a local copy of the graph.

.PP
Each step after the reachability check prompts for confirmation. Use
\fB--yes\fR to accept every prompt, or \fB--skip-skill\fR / \fB--skip-local\fR to
opt out of individual steps. Use \fB--upgrade\fR to re-fetch the skill and
update the local binary in place.

.PP
Exit codes match \fBglab orbit remote\fR — see \fBglab orbit remote --help\fR\&.

.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-g\fP, \fB--global\fP[=false]
	Install the Orbit skill at user scope (\fB~/.agents/skills/\fR). (default false)

.PP
\fB--hostname\fP=""
	GitLab hostname to verify. Defaults to the current repository's host or \fBgitlab.com\fR\&.

.PP
\fB--path\fP=""
	Install the Orbit skill to the directory at \fB<path>\fR\&.

.PP
\fB--skip-local\fP[=false]
	Skip the local CLI binary install step. (default false)

.PP
\fB--skip-skill\fP[=false]
	Skip the agent-skill install step. (default false)

.PP
\fB--upgrade\fP[=false]
	Re-fetch the skill and update the local CLI binary in place. (default false)

.PP
\fB-y\fP, \fB--yes\fP[=false]
	Skip every confirmation prompt. (default false)


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


.SH EXAMPLE
.EX
# Interactive setup (prompts for each step)
$ glab orbit setup

# Non-interactive: accept every prompt
$ glab orbit setup --yes

# Install the skill globally (~/.agents/skills/) instead of in the current repo
$ glab orbit setup --global

# Re-fetch the skill and update the local CLI binary
$ glab orbit setup --upgrade

# Verify reachability only
$ glab orbit setup --skip-skill --skip-local

.EE


.SH SEE ALSO
\fBglab-orbit(1)\fP