
tailscale-notify
- GitHub stars
- 15
Install
/plugin install tailscale-notify@sjungling-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add sjungling/sjungling-claude-plugins.
Contents
Discovered from sourceAgents 1
tailscale-notify
Sends Claude Code notifications to a Tailscale endpoint via HTTP POST.
Installation
/plugin install tailscale-notify@sjungling-plugins
Configuration
Set the TAILSCALE_NOTIFY_URL environment variable to the base URL of your notification endpoint:
export TAILSCALE_NOTIFY_URL="https://your-device.your-tailnet.ts.net:7080"
The hook appends your machine's hostname (lowercase) as the path, so notifications go to $TAILSCALE_NOTIFY_URL/<hostname>. If TAILSCALE_NOTIFY_URL is not set, the hook silently does nothing.
How It Works
When Claude Code sends a notification, this plugin:
- Checks if the macOS screen is locked (using
ioregto queryCGSSessionScreenIsLocked) - If locked, extracts the message content and POSTs it to your Tailscale endpoint
- If unlocked, skips the notification (user is assumed to be actively watching)
- Silently handles failures (best-effort delivery)
The curl request has a 5-second timeout to avoid blocking.
Note: This plugin only sends notifications when the screen is locked, assuming an active user doesn't need remote notifications.
Hooks 1
Sponsors
Details
- Marketplace
- sjungling/sjungling-claude-plugins
- Source
- plugins/tailscale-notify
- Category
- Community