From 8b4525458b5f14c6bef3e40afb595bf31ba78bfc Mon Sep 17 00:00:00 2001
From: David Heinemeier Hansson <david@hey.com>
Date: Wed, 27 May 2026 10:15:12 +0200
Subject: [PATCH] pkexec > sudo

---
 AGENTS.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 15bc29d2..f7ad90b8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -63,6 +63,10 @@ Example:
 - `$OMARCHY_PATH` is set at the top level by the uwsm session environment and is always available to Omarchy runtime code.
 - Commands in `bin/` and Quickshell QML should rely on `$OMARCHY_PATH` / `Quickshell.env("OMARCHY_PATH")`; do not derive fallback paths from `HOME`, `Quickshell.shellDir`, or re-export/default `OMARCHY_PATH` manually.
 
+# Privileged Commands
+
+- Whenever you need to trigger a sudo command, use `pkexec` so it results in a user prompt they can approve.
+
 # Install Scripts
 
 Install entry points (`install.sh`, `boot.sh`) use `#!/bin/bash`. Many scripts under `install/` are sourced via `run_logged` and intentionally do not have shebangs.