Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  on-
       tology 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 dsl				# Full query DSL JSON Schema
       glab orbit remote tools				# MCP tool manifest

       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:

        1: Generic error.

        2:  Orbit  endpoint unavailable (HTTP 404, for	example, when the fea-
	 ture flag is off).

        3: Not	authenticated (HTTP 401).

        4: Access denied (HTTP	403, for example, when no Knowledge Graph  en-
	 abled namespaces exist).

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

SEE ALSO
       glab-orbit(1),  glab-orbit-remote-dsl(1),  glab-orbit-remote-graph-sta-
       tus(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	   Jun 2026			       glab(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=glab-orbit-remote&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help