sjs/vibetunnel
1
0
Fork 0
mirror of https://github.com/samsonjs/vibetunnel.git synced 2026-03-25 09:25:50 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs: add note about Git repository scanning permission prompts

Browse source 
- 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
This commit is contained in:
Peter Steinberger 2025-07-15 19:10:47 +02:00
parent 7462111821
commit 58cc9797de
1 changed files with 10 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
README.md
View file

@ -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.