diff --git a/README.md b/README.md
index a7a7297..32aff90 100644
--- a/README.md
+++ b/README.md
@@ -263,7 +263,7 @@ check reviewer eligibility for a PR, and generate ready-to-paste launcher
 snippets for Claude / Gemini / Codex:
 
 ```bash
-python gitea_config.py menu
+./scripts/gitea-config-menu
 ```
 
 The generated launcher snippets contain only `command`, `args`,
diff --git a/docs/llm-workflow-runbooks.md b/docs/llm-workflow-runbooks.md
index b54d4e5..b2a1acd 100644
--- a/docs/llm-workflow-runbooks.md
+++ b/docs/llm-workflow-runbooks.md
@@ -108,7 +108,7 @@ Run the same server as several launcher entries (e.g. `-author`, `-reviewer`,
 Create and manage profiles without hand-editing JSON:
 
 ```bash
-python gitea_config.py menu
+./scripts/gitea-config-menu
 ```
 
 Menu options: list / add / edit / remove profiles · validate config · test
diff --git a/scripts/gitea-config-menu b/scripts/gitea-config-menu
new file mode 100755
index 0000000..edbdbf7
--- /dev/null
+++ b/scripts/gitea-config-menu
@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+PYTHON="$REPO_ROOT/venv/bin/python"
+
+if [[ ! -x "$PYTHON" ]]; then
+  cat >&2 <<EOF
+Missing repo virtualenv Python: $PYTHON
+
+Create/install the project virtual environment first:
+  python3 -m venv venv
+  ./venv/bin/python -m pip install -r requirements.txt
+
+Then rerun:
+  ./scripts/gitea-config-menu
+EOF
+  exit 1
+fi
+
+exec "$PYTHON" "$REPO_ROOT/gitea_config.py" menu "$@"