GitLabgitlab-org

cli

main
ply7 git calls326 ms99 KiB5 cachedprotocol v2
87 lines6.0 KiBRaw

Configure this machine to record AI agent sessions. (EXPERIMENTAL)

Synopsis

Configure the current machine for AI governance session capture.

Choose the agents to sync with --agents. Without it, setup syncs the agents set up by an earlier run, or Claude Code if there are none. For each agent, setup installs:

  • Claude Code (claude-code): a Stop hook in ~/.claude/settings.json, which syncs the session after every agent turn, and a SessionEnd hook, which syncs the session and marks it completed.
  • OpenCode (opencode), version 1.4 or later: a plugin in ~/.config/opencode/plugins/glab-govern.js (under $XDG_CONFIG_HOME when it is set), which syncs the session every time it goes idle. OpenCode loads it for all your sessions, in every project. Later setups keep it up to date.
  • Codex (codex) and Cursor (cursor): nothing. The fallback periodic sync finds their sessions by scanning their transcripts in ~/.codex/sessions and ~/.cursor/projects, and uploads those from repositories on GitLab hosts you are logged in to with glab. Their sessions are marked completed once they have been idle for 24 hours.

Setup also installs the fallback periodic sync: a launchd agent (~/Library/LaunchAgents/com.gitlab.glab-govern-audit-sync.plist) on macOS, or a systemd user timer (~/.config/systemd/user/glab-govern-audit-sync.timer) on Linux.

The fallback periodic sync runs glab minder audit sync --all every 30 minutes, and on Linux also 5 minutes after boot, until you remove it. It uploads anything the hooks missed for sessions they have already recorded (see glab minder audit sync --help for what is uploaded), using your stored glab credentials and the glab configuration directory in use when you run setup. Each session goes to the project and host of the Git repository the agent ran in. It also marks sessions completed once they have been idle for 24 hours. It pauses sessions from agents that use hooks while those hooks are not installed. Pass --no-fallback-sync to install only the hooks and plugin, which Codex and Cursor cannot be synced without. The fallback periodic sync is not available on Windows.

By default, glab uploads only what each agent does after you first set it up: not its sessions from before, and not the earlier turns of a session from before that you resume.

Cursor records no times, so setup notes where each existing Cursor transcript ends, and only what is added to it afterwards is uploaded. A chat that Cursor copies under a new ID, for example when you duplicate it, counts as a new session and is uploaded in full.

Pass --include-history to also upload activity from the last 89 days, including those sessions and turns, for the agents this setup sets up for the first time. For Cursor, that is every transcript changed in the last 89 days. An agent set up earlier keeps what it uploads, so to add its history, run --uninstall first. If you set up an agent with an earlier glab version, which did not record when, its activity from the last 89 days is still uploaded until you run setup again.

Run setup again with --agents to add agents. Agents set up by an earlier run stay set up, so to stop syncing an agent, run --uninstall and then set up the agents you want. Every setup prompt names the agents that are synced.

Safe to run multiple times: existing hooks are not duplicated, and an existing fallback periodic sync job is replaced. Run glab minder doctor afterwards to verify the setup.

Run glab minder setup --uninstall to remove everything setup installed: the hooks, the OpenCode plugin, the fallback periodic sync job, and Codex and Cursor session syncing. It also removes glab's local records of your agent sessions and forgets the agents you set up and when, so the next setup starts with Claude Code again. Other hooks and settings in ~/.claude/settings.json, and other OpenCode plugins, are left unchanged.

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

plaintext
glab minder setup [flags]

Examples

console
# Sync Claude Code sessions, or the agents set up earlier
$ glab minder setup

# Sync OpenCode sessions
$ glab minder setup --agents opencode

# Sync Claude Code, OpenCode, and Codex sessions
$ glab minder setup --agents claude-code,opencode,codex

# Also upload activity from the last 89 days, including sessions from before setup
$ glab minder setup --include-history

# Install only the hooks and plugin, without the fallback periodic sync
$ glab minder setup --no-fallback-sync

# Remove everything setup installed
$ glab minder setup --uninstall

Options

plaintext
      --agents strings     Agents to sync sessions from: claude-code, opencode, codex, cursor. Added to the agents set up by an earlier run. The OpenCode plugin runs for all your OpenCode sessions. Multiple agents can be comma-separated or specified by repeating the flag.
      --include-history    Also upload the activity from the last 89 days of the agents set up for the first time, including sessions from before setup and the earlier turns of sessions you resume.
      --no-fallback-sync   Install only the hooks and plugin, without the fallback periodic sync job.
      --uninstall          Remove the hooks, the OpenCode plugin, the fallback periodic sync job, and the local session records, and stop syncing Codex and Cursor sessions.
  -y, --yes                Skip the confirmation prompt, and agree to what it would describe: the changes and, for setup, the uploads.

Options inherited from parent commands

plaintext
  -h, --help   Show help for this command.
1---
2title: '`glab minder setup`'
3stage: AI Clients
4group: Developer Clients
5info: To determine the technical writer assigned to the Stage/Group associated with this page, see <https://handbook.gitlab.com/handbook/marketing/product-and-technical-marketing/technical-writing/#assignments>
6---
8<!--
9This documentation is auto generated by a script.
10Please do not edit this file directly. Run `make gen-docs` instead.
11-->
13Configure this machine to record AI agent sessions. (EXPERIMENTAL)
15## Synopsis
17Configure the current machine for AI governance session capture.
19Choose the agents to sync with `--agents`. Without it, setup syncs the agents set up by an earlier run, or Claude Code if there are none. For each agent, setup installs:
21- Claude Code (`claude-code`): a Stop hook in `~/.claude/settings.json`, which syncs the session after every agent turn, and a SessionEnd hook, which syncs the session and marks it completed.
22- OpenCode (`opencode`), version 1.4 or later: a plugin in `~/.config/opencode/plugins/glab-govern.js` (under `$XDG_CONFIG_HOME` when it is set), which syncs the session every time it goes idle. OpenCode loads it for all your sessions, in every project. Later setups keep it up to date.
23- Codex (`codex`) and Cursor (`cursor`): nothing. The fallback periodic sync finds their sessions by scanning their transcripts in `~/.codex/sessions` and `~/.cursor/projects`, and uploads those from repositories on GitLab hosts you are logged in to with glab. Their sessions are marked completed once they have been idle for 24 hours.
25Setup also installs the fallback periodic sync: a launchd agent (`~/Library/LaunchAgents/com.gitlab.glab-govern-audit-sync.plist`) on macOS, or a systemd user timer (`~/.config/systemd/user/glab-govern-audit-sync.timer`) on Linux.
27The fallback periodic sync runs `glab minder audit sync --all` every 30 minutes, and on Linux also 5 minutes after boot, until you remove it. It uploads anything the hooks missed for sessions they have already recorded (see `glab minder audit sync --help` for what is uploaded), using your stored glab credentials and the glab configuration directory in use when you run setup. Each session goes to the project and host of the Git repository the agent ran in. It also marks sessions completed once they have been idle for 24 hours. It pauses sessions from agents that use hooks while those hooks are not installed. Pass `--no-fallback-sync` to install only the hooks and plugin, which Codex and Cursor cannot be synced without. The fallback periodic sync is not available on Windows.
29By default, glab uploads only what each agent does after you first set it up: not its sessions from before, and not the earlier turns of a session from before that you resume.
31Cursor records no times, so setup notes where each existing Cursor transcript ends, and only what is added to it afterwards is uploaded. A chat that Cursor copies under a new ID, for example when you duplicate it, counts as a new session and is uploaded in full.
33Pass `--include-history` to also upload activity from the last 89 days, including those sessions and turns, for the agents this setup sets up for the first time. For Cursor, that is every transcript changed in the last 89 days. An agent set up earlier keeps what it uploads, so to add its history, run `--uninstall` first. If you set up an agent with an earlier glab version, which did not record when, its activity from the last 89 days is still uploaded until you run setup again.
35Run setup again with `--agents` to add agents. Agents set up by an earlier run stay set up, so to stop syncing an agent, run `--uninstall` and then set up the agents you want. Every setup prompt names the agents that are synced.
37Safe to run multiple times: existing hooks are not duplicated, and an existing fallback periodic sync job is replaced. Run `glab minder doctor` afterwards to verify the setup.
39Run `glab minder setup --uninstall` to remove everything setup installed: the hooks, the OpenCode plugin, the fallback periodic sync job, and Codex and Cursor session syncing. It also removes glab's local records of your agent sessions and forgets the agents you set up and when, so the next setup starts with Claude Code again. Other hooks and settings in `~/.claude/settings.json`, and other OpenCode plugins, are left unchanged.
41This feature is an experiment and is not ready for production use.
42It might be unstable or removed at any time.
43For more information, see
44<https://docs.gitlab.com/policy/development_stages_support/>.
46```plaintext
47glab minder setup [flags]
48```
50## Examples
52```console
53# Sync Claude Code sessions, or the agents set up earlier
54$ glab minder setup
56# Sync OpenCode sessions
57$ glab minder setup --agents opencode
59# Sync Claude Code, OpenCode, and Codex sessions
60$ glab minder setup --agents claude-code,opencode,codex
62# Also upload activity from the last 89 days, including sessions from before setup
63$ glab minder setup --include-history
65# Install only the hooks and plugin, without the fallback periodic sync
66$ glab minder setup --no-fallback-sync
68# Remove everything setup installed
69$ glab minder setup --uninstall
71```
73## Options
75```plaintext
76 --agents strings Agents to sync sessions from: claude-code, opencode, codex, cursor. Added to the agents set up by an earlier run. The OpenCode plugin runs for all your OpenCode sessions. Multiple agents can be comma-separated or specified by repeating the flag.
77 --include-history Also upload the activity from the last 89 days of the agents set up for the first time, including sessions from before setup and the earlier turns of sessions you resume.
78 --no-fallback-sync Install only the hooks and plugin, without the fallback periodic sync job.
79 --uninstall Remove the hooks, the OpenCode plugin, the fallback periodic sync job, and the local session records, and stop syncing Codex and Cursor sessions.
80 -y, --yes Skip the confirmation prompt, and agree to what it would describe: the changes and, for setup, the uploads.
81```
83## Options inherited from parent commands
85```plaintext
86 -h, --help Show help for this command.
87```
Diagnostics7 git calls · 326 ms
CallStatusSizeTime0326 ms
discover200185 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=185
git.server.agent=git/2.56.g1891de4-Linux
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch server-option object-format
git.server.fetch=shallow wait-for-done filter
git.protocol.version=2
git.pkt.frames=9
git.pkt.data=7
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=185
git.pkt.payload.max=35
ls-refs20058 KiB · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=59849
git.response.cache=HIT
git.response.duration_ms=3
git.protocol.version=2
git.pkt.frames=731
git.pkt.data=730
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=59849
git.pkt.payload.max=143
git.ls_refs.count=730
git.ls_refs.head=refs/heads/main
fetchtree:0 · deepen 1020032 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=32926
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=22
git.pkt.data=20
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=32926
git.pkt.payload.max=32046
git.sideband.band1.bytes=32046
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=80
git.pack.bytes=32046
git.pack.ofs_delta=36
git.pack.ref_delta=0
git.pack.chain.max=2
git.pack.trailer=cb0bad5d7ffc514895d8b21c4dd470327f90bc91
git.pack.full=44
Open pack map
fetchcombine:blob:none+tree:2 · deepen 12004.2 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=4273
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=combine:blob:none+tree:2
git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9
git.fetch.haves.count=0
git.fetch.deepen=1
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=7
git.pkt.data=5
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=4273
git.pkt.payload.max=4173
git.sideband.band1.bytes=4173
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=11
git.pack.bytes=4173
git.fetch.wide.objects=11
git.fetch.wide.extra_bytes=3930
git.fetch.wide.blobs=0
fetchtree:02001.7 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=1744
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=5e4007a5673eb3bf5d0d7f1a1463c3b2ca3fb3bd
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1744
git.pkt.payload.max=1717
git.sideband.band1.bytes=1717
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=1717
git.pack.trailer=3f1b9ccc7756e8941d6705e8187c87fd922113e6
Open pack map
fetchtree:0200234 B · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=234
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=tree:0
git.fetch.wants=d4c4034fec41451ca74e17cf52a088b633742881
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=234
git.pkt.payload.max=207
git.sideband.band1.bytes=207
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=207
git.pack.trailer=d22a96a8122877370a1e80e255b15b5fee035ecb
Open pack map
fetch2002.4 KiB316 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=316
git.response.bytes=2420
git.response.cache=MISS
git.response.duration_ms=316
git.fetch.wants=3ca89e81c5c7a1f332935a673c1eefdf1416fe85
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=4
git.pkt.data=3
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=2420
git.pkt.payload.max=2393
git.sideband.band1.bytes=2393
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://gitlab.com/gitlab-org/cli
Ref
refs/heads/main
Commit
0dd7574dce9e385c5c30540e6c15657adc6bdce9
cf-ray
a5e130163bfea9fe
Request
67f58715…
Protocol
v2 · sha1
Agent
git/2.56.g1891de4-Linux
Filter
advertised
Fetch
shallow wait-for-done filter
Capabilities
agent ls-refs fetch server-option object-format