Notifications

Shinphony Hook

Set up Shinphony Hook on your Mac, Linux or Windows SSH host for task notifications: installation, status checks, updates and privacy.

Shinphony Hook is the optional notification component that runs on your computer, separate from herdr-core. Codex and Claude Code call it when a task starts, finishes or asks a question; it sends a short event through our relay to Apple's push service.

The quickest install is one line on the computer: curl -fsSL https://shinphony.app/pair | sh on macOS or Linux, irm https://shinphony.app/pair.ps1 | iex in Windows PowerShell. Then scan the code from Add server.

Install from the app

Connect to the server, then open the terminal tab’s More → Task notifications. Enable notifications, allow the system permission, and choose Set up notifications. Review the setup disclosure before accepting. The app installs the hook over SSH, registers a user-level service (launchd on macOS, systemd on Linux, Task Scheduler on Windows; no sudo) and adds its entries to Codex and Claude Code. Codex asks once to trust the new hooks: allow them, then restart or resume your session.

Use Check status to inspect setup before retrying. For a deliberate completion test and supported delivery routes, follow the Shinphony Hook setup guide. SSH and hc attachment do not require Hook.

Updates

Hook updates use signed releases and require your opt-in. Codex may ask to trust the hooks again after an update.

What it sends

Task status, the agent, the project name, short summaries and a question with its options. Optional context can include up to six terminal-output lines (700 UTF-8 bytes), which may contain code or sensitive information. It passes through Potafree and Apple and can appear on your Lock Screen. Do not rely on automatic redaction; avoid printing secrets. SSH credentials and SFTP file transfers do not pass through the notification relay. See the privacy policy.

Step by step: Install, test and manage notifications.

Current App Store release: 1.1.0 · Updated 2026-11-13