Notifications

Tusk has two channels for notifications: macOS system notifications (the ones that pop up at the top right of your screen) and the in-app notifications panel (accessible from the bell icon in the topbar). Both are driven by the same notification system, so anything you see in macOS notifications is also recorded in the in-app panel.

What categories Tusk uses

• Job completion: an offload, restore, or large sync finished. Useful when you started something long-running and walked away.
• Job error: a job ended with errors (one or more files failed). Tusk groups these per job so you don't get spammed.
• Drive connected / disconnected: optional. Off by default for connections (too noisy); on by default for disconnects during active jobs.
• Verification: missing files detected: a verification pass found files Tusk expected to be on a destination that aren't there. One notification per project per pass with a count.
• Credentials expired: a Google Drive OAuth token expired or an S3 key stopped working. Includes a deep link to refresh in Preferences.
• Folder missing: a project's primary folder was renamed or deleted. Includes a link to relink.
• License / activation: trial expiration warnings, grace-period countdown.
• Update available: a new version of Tusk is ready to install.

Tuning what you see

From Preferences → Notifications, you can toggle each category on or off. The default settings favor signal over noise: critical states (errors, missing files, credentials) are on; informational states (every sync completion, every drive connect) are off.

You can also disable macOS system notifications entirely while keeping the in-app panel populated. Useful if you want a record of events to refer back to but don't want pop-ups while you're editing.

Grouping and deduplication

Tusk groups related events to keep the panel quiet. A single verification pass that finds 47 missing files on one destination produces one notification with a count, not 47 separate entries. A drive that disconnects and reconnects in quick succession produces a single summary, not two.

Acting on notifications

Most notifications include a deep link or an inline action button. Click them to land directly on the right screen with the right context loaded:

• Job error → opens the Jobs page with the failing job selected and the error log expanded.
• Missing files → opens the project file table filtered to just the missing rows.
• Credentials expired → opens Preferences > Accounts on the failing entry.
• Folder missing → opens the project page with the relink modal pre-loaded.
• Update available → opens the auto-update dialog.

Clearing the panel

The notifications panel keeps a rolling window of recent events. Acknowledge an entry to clear it, or use Clear all at the top of the panel. Cleared entries are gone from the panel but still show up in the logs (Help > Open Logs from the macOS menu bar) for the same retention period.