From 7649d53f3bf83df8e925f4c275c37f634ec2e202 Mon Sep 17 00:00:00 2001 From: Joakim Persson Date: Sun, 9 Aug 2026 15:42:29 +0200 Subject: [PATCH] .env.example: say why GIT_USER_* must be set MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Both keys shipped empty with no explanation, so they read as optional. They are not: ~/.gitconfig is not on a persistent mount, so with these unset every repo in the container fails "Author identity unknown" on first commit after every recreate — and an agent asked to commit then infers an identity from git log and picks the wrong one. Observed today across three repos on one machine (two wrong-address commits, plus older `pi ` fossils from earlier sessions guessing the same way). Also records that the address is per-machine (corporate vs private), so it belongs in the per-machine .env rather than a skill or a repo-local override. --- .env.example | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/.env.example b/.env.example index bee2d69..b03361f 100644 --- a/.env.example +++ b/.env.example @@ -52,6 +52,13 @@ SSH_KEY_PATH=~/.ssh # DEVBOX_ATELIER=1 # ── Git Configuration ──────────────────────────────────────────────── +# Set BOTH. If unset, every repo inside the container fails with +# "Author identity unknown" on first commit, and an agent asked to commit +# will guess an identity from git log — often the wrong one. The e-mail is +# per-machine (work machines use the corporate address, personal machines the +# private one), so it belongs in this per-machine .env, never in a skill or a +# repo-local override. Consumed by entrypoint-user.sh -> ~/.gitconfig, which is +# NOT persistent across container recreate — this file is the source of truth. GIT_USER_NAME= GIT_USER_EMAIL=