From 58cc9797dedcd5b91e1114912827105179b7549c Mon Sep 17 00:00:00 2001 From: Peter Steinberger Date: Tue, 15 Jul 2025 19:10:47 +0200 Subject: [PATCH] docs: add note about Git repository scanning permission prompts - Explain that first session Git scanning triggers macOS filesystem permissions - List common protected folders (Desktop, Documents, Downloads, iCloud Drive) - Provide workarounds to avoid prompts - Include link to detailed explanation about macOS privacy-protected folders --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 4a533ce1..38f782a0 100644 --- a/README.md +++ b/README.md @@ -91,6 +91,16 @@ vt claude-danger # Your custom aliases are resolved vt --shell ``` +### Git Repository Scanning on First Session + +When opening a new session for the first time, VibeTunnel's working directory scanner will look for Git repositories. By default, this scans your home directory, which may trigger macOS permission prompts for accessing protected folders (like Desktop, Documents, Downloads, iCloud Drive, or external volumes). + +To avoid these prompts: +- **Option 1**: Navigate to your actual projects directory before opening a session +- **Option 2**: Accept the one-time permission prompts (they won't appear again) + +This only happens on the first session when the scanner discovers your Git repositories. For more details about macOS privacy-protected folders, see [this explanation](https://eclecticlight.co/2025/02/24/gaining-access-to-privacy-protected-folders/). + ### 4. Open Your Dashboard Visit [http://localhost:4020](http://localhost:4020) to see all your terminal sessions.