From 2a370f8038224859713010857a90037aa8298340 Mon Sep 17 00:00:00 2001
From: Daniel Olowoniyi <101122783+Danztee@users.noreply.github.com>
Date: Wed, 21 Jan 2026 19:52:21 +0100
Subject: feat: implement home directory expansion for permission patterns
 using `~` and `$HOME` prefixes. (#9813)

---
 packages/web/src/content/docs/permissions.mdx | 8 ++++++++
 1 file changed, 8 insertions(+)

(limited to 'packages/web')

diff --git a/packages/web/src/content/docs/permissions.mdx b/packages/web/src/content/docs/permissions.mdx
index 4df3841e3..229cb264e 100644
--- a/packages/web/src/content/docs/permissions.mdx
+++ b/packages/web/src/content/docs/permissions.mdx
@@ -78,6 +78,14 @@ Permission patterns use simple wildcard matching:
 - `?` matches exactly one character
 - All other characters match literally
 
+### Home Directory Expansion
+
+You can use `~` or `$HOME` at the start of a pattern to reference your home directory. This is particularly useful for `external_directory` rules.
+
+- `~/projects/*` -> `/Users/username/projects/*`
+- `$HOME/projects/*` -> `/Users/username/projects/*`
+- `~` -> `/Users/username`
+
 ---
 
 ## Available Permissions
-- 
cgit v1.2.3