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

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

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

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

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

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

SEE ALSO
glab-orbit(1)