[Bug]: herd link claims success but symlink not created; GUI Add Site fails

[fhsheridan]

Platform

macOS

Operating system version

macOS Sequoia 15.5

System architecture

ARM64 (M1, M2, etc)

Herd Version

1.20.3 (Build 48)

PHP Version

No response

Bug description

Running herd link reports a successful symbolic link creation, but no symlink appears in the expected directory. Additionally, using the GUI to add or link an existing site fails with the error:

"There was an error creating your application."

Steps to reproduce

1. Navigate to your repo root, e.g., ~/documents/code/repo-name.

2. Run the command:

   herd link

3. Observe the success message claiming a symlink was created at:
   /Users/name/Library/Application Support/Herd/config/valet/Sites/[name-web-app]

4. Check the directory and find no symlink actually created.

5. In the Herd GUI, try Add Sites → Link Existing Site.

6. The GUI operation fails with the error:
   "There was an error creating your application."

Relevant log output

[fhsheridan]

This would appear to be an issue with permissions on a multi-account machine.

Herd was installed using a standard account with escalation to administrator credentials when moved to Applications folder on macos.

We suspect that Herd needs admin permissions to complete the creation of symlinks.