feat: implement home directory expansion for permission patterns using ~ and $HOME prefixes. (#9813)

2026-01-21 19:52:21 +01:00
parent d9f0287d74
commit 2a370f8038
3 changed files with 58 additions and 1 deletions
--- 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