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

.SH NAME
glab-orbit-remote-graph-status - Show indexing progress for a namespace or project. (EXPERIMENTAL)


.SH SYNOPSIS
\fBglab orbit remote graph-status [flags]\fP


.SH DESCRIPTION
Calls \fBGET /api/v4/orbit/graph_status\fR and prints the
indexing-progress response as pretty-printed JSON. The response
carries project counts, per-domain entity counts, and the overall
indexing run state for the requested scope.

.PP
Exactly one of \fB--namespace-id\fR, \fB--project-id\fR, or
\fB--full-path\fR is required. \fB--full-path\fR accepts the
full path of a project or group. For example, \fBgitlab-org/gitlab\fR\&.

.PP
Unlike \fBglab orbit remote query\fR, this endpoint defaults to
the \fBraw\fR response format. Use \fB--format llm\fR for
compact output intended for agents.

.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
\fB-f\fP, \fB--format\fP="raw"
	Response format: \fBraw\fR (structured JSON) or \fBllm\fR (compact, intended for agents).

.PP
\fB--full-path\fP=""
	Full path of a project or group, such as \fBgitlab-org/gitlab\fR\&. Cannot be used with the ID flags.

.PP
\fB--hostname\fP=""
	GitLab hostname to query. Defaults to the current repository's host or \fBgitlab.com\fR\&.

.PP
\fB--jq\fP=""
	Filter JSON output with a jq expression.

.PP
\fB--namespace-id\fP=0
	Namespace (group) ID to inspect. Cannot be used with --project-id or --full-path.

.PP
\fB--project-id\fP=0
	Project ID to inspect. Cannot be used with --namespace-id or --full-path.


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB-h\fP, \fB--help\fP[=false]
	Show help for this command.


.SH EXAMPLE
.EX
# Look up indexing progress by full path
$ glab orbit remote graph-status --full-path gitlab-org/gitlab

# Or by numeric ID
$ glab orbit remote graph-status --project-id 278964
$ glab orbit remote graph-status --namespace-id 9970

# Compact output for agents
$ glab orbit remote graph-status --full-path gitlab-org/gitlab --format llm

.EE


.SH SEE ALSO
\fBglab-orbit-remote(1)\fP