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

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


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


.SH 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 \fBknowledge_graph\fR
feature flag.

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

.EX
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 dsl                            # Full query DSL JSON Schema
glab orbit remote tools                          # MCP tool manifest
.EE

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

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

.PP
Inspect indexing progress for a namespace or project:

.EX
glab orbit remote graph-status --full-path gitlab-org/gitlab
.EE

.PP
Exit codes:
.IP \(bu 2
1: Generic error.
.IP \(bu 2
2: Orbit endpoint unavailable (HTTP 404, for example, when the feature flag is off).
.IP \(bu 2
3: Not authenticated (HTTP 401).
.IP \(bu 2
4: Access denied (HTTP 403, for example, when no Knowledge Graph enabled
namespaces exist).
.IP \(bu 2
5: Rate limited (HTTP 429).

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


.SH EXAMPLE
.EX
# Discovery workflow (always start here)
$ glab orbit remote status
$ glab orbit remote schema
$ glab orbit remote schema User Project MergeRequest
$ glab orbit remote dsl
$ 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

.EE


.SH SEE ALSO
\fBglab-orbit(1)\fP, \fBglab-orbit-remote-dsl(1)\fP, \fBglab-orbit-remote-graph-status(1)\fP, \fBglab-orbit-remote-query(1)\fP, \fBglab-orbit-remote-schema(1)\fP, \fBglab-orbit-remote-status(1)\fP, \fBglab-orbit-remote-tools(1)\fP