Platform-specific behavior: webview engines and deployment. See Architecture for the service daemon design, gRPC protocol, and window positioning.
| Platform | Engine |
|---|---|
| Windows | WebView2 (Edge/Chromium) |
| macOS | WKWebView (Safari) |
| Linux | WebKitGTK |
The hermes serve daemon runs per-user in the desktop session. Run the installer; it handles placement, autostart, and MOTD. No additional setup.
| Platform | Install | Autostart | App launcher |
|---|---|---|---|
| Windows | hermes.msi | HKLM Run key at logon. hermes install also launches the daemon immediately in all active user sessions via Win32 CreateProcessAsUser. |
Start Menu shortcut "Hermes Notifications" (via conhost --headless to suppress console window) |
| Linux | sudo dpkg -i hermes.deb |
systemd user unit + profile.d. hermes install also launches the daemon immediately for all logged-in users via SysProcAttr.Credential. |
.desktop file with Keywords=notifications;alerts;history; |
| macOS | hermes.pkg (universal, Intel + Apple Silicon) | LaunchAgent in /Library/LaunchAgents; profile.d + zprofile snippet via postinstall. hermes install also launches the daemon immediately for all active users. |
"Hermes Notifications.app" in /Applications (shell launcher to hermes history) |
Silent / MDM install
By default the Windows MSI shows the setup wizard; use the parameters below for unattended installs.
| Platform | Silent install |
|---|---|
| Windows | msiexec /i hermes.msi /qn |
| Linux | sudo apt install -y ./hermes.deb |
| macOS | installer -pkg hermes.pkg -target / (universal binary, works on both Intel and Apple Silicon) |
See Architecture — Deployment for detail.
Users who connect via SSH without a desktop session won't see the Wails UI. The installers include a login banner that shows notification summaries on shell login:
| Platform | Mechanism |
|---|---|
| Linux | /etc/profile.d/hermes-motd.sh (installed by .deb) |
| macOS | /etc/profile.d/hermes-motd.sh (installed by .pkg; postinstall ensures zsh sources profile.d) |
| Windows | Guarded one-liner in $PROFILE.AllUsersAllHosts (installed by MSI) |
The banner only appears for SSH sessions (detected via $SSH_CLIENT / $SSH_TTY on Unix, $env:SSH_CLIENT / $env:SSH_CONNECTION on Windows). It runs hermes history --json and prints a summary. Silent when there are no notifications needing attention. Run hermes history for full details.