From 95178e3e96ca68287bf6ffc393b6cf397cfc6e3a Mon Sep 17 00:00:00 2001
From: clearbluejar <clearbluejar@users.noreply.github.com>
Date: Fri, 17 Apr 2026 07:01:18 -0600
Subject: [PATCH] Document GUI CI user agreement override

---
 DevGuide.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/DevGuide.md b/DevGuide.md
index ed46d21d14..c08f6afb35 100644
--- a/DevGuide.md
+++ b/DevGuide.md
@@ -175,6 +175,13 @@ export DISPLAY=:99
 ```
 This is required to make AWT happy.
 
+In a clean user environment, GUI startup may also block on the first-run User Agreement dialog
+before the FrontEnd becomes available. For non-interactive GUI startup in CI, set:
+```
+export JAVA_TOOL_OPTIONS="-DUSER_AGREEMENT=ACCEPT"
+```
+This allows GUI-based automation to avoid blocking on the initial agreement prompt.
+
 ## Building Supporting Data
 
 Some features of Ghidra require the curation of rather extensive databases. These include the Data