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

.SH NAME
glab-govern-audit-sync - Sync agent session data to GitLab. (EXPERIMENTAL)


.SH SYNOPSIS
\fBglab govern audit sync [flags]\fP


.SH DESCRIPTION
Read new entries from the local agent transcript since the last sync
and POST them to GitLab as audit events.

.PP
Called by the Stop hook after every agent turn. Also used by the
SessionEnd hook (with --complete) to mark the session as complete.

.PP
Project is resolved from:
.IP "  1." 5
--project flag (requires --hostname)
.IP "  2." 5
Git remote of the current directory

.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--complete\fP[=false]
	Mark the session as completed. Used by the SessionEnd hook.

.PP
\fB-H\fP, \fB--hostname\fP=""
	GitLab hostname (required with --project).

.PP
\fB-p\fP, \fB--project\fP=""
	Project ID or path to sync against.

.PP
\fB--silent\fP[=false]
	Suppress all output. Used when invoked from hooks.


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


.SH EXAMPLE
.EX
# Sync the current agent session to GitLab
$ glab govern audit sync

# Sync and mark the session as completed
$ glab govern audit sync --complete

# Sync against a specific project
$ glab govern audit sync --project my-group/my-project --hostname gitlab.com

.EE


.SH SEE ALSO
\fBglab-govern-audit(1)\fP