AGENTS.md@opt/scripts/git git:20260905.9f73e3aA

Immutable. This exact content is served forever at /api/v1/blob/5b3ea9182b9c9fc8.

# Git Utilities (opt/scripts/git)

- `git_identity_doctor.sh`: Verifies git user.email against the authenticated GitHub account (run by install.sh and `make git-doctor`); `git_identity_doctor_test.sh` is its CI test driver.
- `install_git_hooks.sh`: Installs the privacy git hooks (`ai/githooks/pre-commit`, `commit-msg`, `pre-push` + the shared `ai/hooks/privacy_rules.sh`) into `~/.config/git/hooks` and sets the global `core.hooksPath` (never clobbers a different existing value — warns instead). Run by install.sh (gff flag `install.git.hooks`); `install_git_hooks_test.sh` is its hermetic driver, part of `make hook-test`.
- `install_gitleaks.sh`: Installs the `gitleaks` binary (apt → brew → sha256-verified release download; `GITLEAKS_INSTALL_METHOD` forces one) for the privacy guard's secret rules; `--off` writes the `~/.config/privacy_guard/gitleaks=off` marker instead. Run by install.sh (gff flag `install.git.gitleaks`); `install_gitleaks_test.sh` is its hermetic driver.
- `privacy_guard_timing.sh`: `make hook-timing` — per-hook timing stats from the privacy guard's log, red when any run exceeds the budget; `privacy_guard_timing_test.sh` drives it.
- `git_add.sh`, `git_branch.sh`, `git_pull.sh`: Basic git operations.
- `git-local-master.sh`: Helper for managing local master branches.
- `git-rm-mybranches.sh`: Cleanup utility for personal branches.
- `git-signoff.sh`: Adds sign-off to commits.
- `update_origin.sh`: Updates the remote origin URL.
- `gh_issues.rb`: Script for managing GitHub issues.

Interactive git shortcuts (`git-reset`, `git-reset-all`, `git-clean`, `git-help`)
live in [`opt/profiles/.gitools.sh`](../../profiles/.gitools.sh) — the slim
replacement for the retired Gerrit-era `setup_git_alias.sh` / `~/.gitenv`
generator (removed 2026-08-08; git history has the old toolset).