glab(1)

NAME

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

SYNOPSIS

glab orbit setup [flags]

DESCRIPTION

Run a guided onboarding for the GitLab Knowledge Graph (Orbit):

1.: Verify that Orbit is reachable and enabled for your user.
2.: Install the Orbit agent skill so AI coding agents can discover it.
3.: Install the Orbit local CLI binary for indexing a local copy of the graph.

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

Exit codes match glab orbit remote — see glab orbit remote --help.

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

-g, --global[=false] Install the Orbit skill at user scope (~/.agents/skills/). (default false)

--hostname="" GitLab hostname to verify. Defaults to the current repository's host or gitlab.com.

--path="" Install the Orbit skill to the directory at <path>.

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

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

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

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

OPTIONS INHERITED FROM PARENT COMMANDS

-h, --help[=false] Show help for this command.

EXAMPLE

# 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