glab(1)                                                                glab(1)



NAME
       glab-orbit-remote - Interact with the remote GitLab Knowledge Graph.
       (EXPERIMENTAL)



SYNOPSIS
       glab orbit remote  [flags]



DESCRIPTION
       Query the remote GitLab Knowledge Graph (product name: Orbit) directly
       from the CLI. All endpoints are user-scoped (not project-scoped) and
       gated behind the knowledge_graph feature flag.


       Start with these discovery commands. They return the authoritative
       ontology and query DSL schema:

       glab orbit remote status                         # Is the service up?
       glab orbit remote schema                         # What entities and edges exist?
       glab orbit remote schema MergeRequest Project    # Show details for specific nodes
       glab orbit remote tools                          # Full DSL JSON Schema


       After you know the shape of the graph, run a query:

       glab orbit remote query path/to/query.json
       cat query.json | glab orbit remote query -


       Inspect indexing progress for a namespace or project:

       glab orbit remote graph-status --full-path gitlab-org/gitlab


       Exit codes:

       o 1: Generic error.

       o 2: Orbit endpoint unavailable (HTTP 404, for example, when the
         feature flag is off).

       o 3: Not authenticated (HTTP 401).

       o 4: Access denied (HTTP 403, for example, when no Knowledge Graph
         enabled namespaces exist).

       o 5: Rate limited (HTTP 429).


       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 INHERITED FROM PARENT COMMANDS
       -h, --help[=false]  Show help for this command.



EXAMPLE
       # Discovery workflow (always start here)
       $ glab orbit remote status
       $ glab orbit remote schema
       $ glab orbit remote schema User Project MergeRequest
       $ glab orbit remote tools

       # Run a query from a file
       $ glab orbit remote query ./query.json

       # Run a query from stdin (raw output for jq pipelines)
       $ echo '{"query":{"query_type":"traversal","node":{"id":"p","entity":"Project"},"limit":5}}' \
           | glab orbit remote query --format raw -

       # Inspect indexing progress
       $ glab orbit remote graph-status --full-path gitlab-org/gitlab




SEE ALSO
       glab-orbit(1), glab-orbit-remote-graph-status(1), glab-orbit-remote-
       query(1), glab-orbit-remote-schema(1), glab-orbit-remote-status(1),
       glab-orbit-remote-tools(1)

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