glab(1)                                                                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




SEE ALSO
       glab-orbit(1)

Auto generated by spf13/cobra      Jun 2026                            glab(1)