Install Span Coding Hooks on macOS

Before you start

• A Mac running macOS 13 or later

• Admin access (sudo)

• Your Span auth token (provided by your Span administrator)

• Your work email

Step 1: Download the files

Save both files into the same folder on your Mac (e.g. ~/Downloads/):

• coding-hooks-latest.pkg

• macos-with-sudo-access.sh

💡 When you download it might show a warning that it "can't scan this file for viruses." This is normal for any shell script. The script is safe: its only job is to install the coding-hooks-latest.pkg and save your auth token and work email locally. Click Download anyway to continue.

Step 2: Run the install

Open the Terminal app, cd into the folder where you downloaded the files, then paste the command below. Replace <VERSION> with the version number from your downloaded pkg filename, and <TOKEN> and <EMAIL> with your values:

cd <path/to/folder>     # e.g. cd ~/Downloads
sudo bash macos-with-sudo-access.sh \
  --pkg coding-hooks-<VERSION>.pkg \
  --token <TOKEN> \
  --email <EMAIL>

Enter your Mac password when prompted (characters won't appear as you type, which is normal).

✅ Done when you see: Result: 11/11 checks OK

Verify anytime

~/.span/bin/span-health

Uninstall (if needed)

sudo bash "/Library/Application Support/app.span.coding-hooks/uninstall.sh"

Troubleshooting

• Error: must run as root (use sudo). Re-run with sudo at the start of the command.

• Error: --pkg path not found: ... The pkg isn't where the command expects. Make sure you cd'd into the folder where you saved the pkg (run ls coding-hooks*.pkg to confirm), then re-run.

• Error: --email does not look like an email address: ... Pass a valid email like you@yourcompany.com.

• Error: --token ... is required. Re-run with the Span auth token your Span administrator gave you.

• span-health shows delivery-log ... error(s) Usually clears within a few minutes. If the count keeps growing, contact the Span team.

Stuck on something not listed here? Share the full Terminal output with the Span team.