Push Notifications

Know when Claude Code, Pi, or another agent needs you. Encrypted, smart, and instant.

How It Works

1

Install

Run the setup script on your server

2

Pair

Scan the QR code in Attach to link your phone

3

Get notified

Tap a notification to jump straight to the right pane

01

Install

curl -fsSL https://attach.sh/install/notify | bash

Run this on the machine where Claude Code runs. A QR code will appear in your terminal.

02

Pair

Open Attach on your phone and go to Settings → Push Notifications → Scan QR Code. Scan the QR code displayed in your terminal.

Pair each server once. If you can't scan the QR, you can enter the pairing token and encryption key manually and then bind them to the matching saved connection.

03

Built for privacy and speed

One-tap deep link

Tap a notification to open Attach and jump directly to the tmux pane that needs attention. No navigating through sessions and windows.

Smart notifications

Only notifies when you're away from your computer. Automatically detects activity on macOS and Linux — no unnecessary alerts while you're working.

End-to-end encrypted

All notifications are encrypted with AES-256 before leaving your server. The relay never sees notification content; during QR setup it may receive the encryption key transiently to render the code, but it does not store keys.

04

What Gets Installed

attach-notify

A lightweight bash script at ~/.local/bin/attach-notify that encrypts and sends push notifications through our relay.

Notifications are encrypted on your server before they leave. During QR-code setup, the relay may receive the encryption key transiently to render the code, but it does not store keys.

Claude Code hooks

Notification hooks added to ~/.claude/settings.json that trigger attach-notify when Claude Code needs your attention.

Fires on permission prompts and when waiting for input.

05

Works With Any Agent

attach-notify is agent-agnostic. Any coding agent that can run a shell command — Pi, Codex, OpenCode, OpenClaw, or your own scripts — can send push notifications to Attach today.

The setup script currently configures Claude Code hooks automatically. Built-in hook setup for more agents is coming soon.