# pinged.fyi

Free push notifications for humans and their agents. No accounts. A topic is
an unguessable ID; anyone holding it can publish to it and subscribe.

## Install the CLI (includes an MCP server)

macOS/Linux:  curl -fsSL https://pinged.fyi/install | sh
Windows:      irm https://pinged.fyi/install.ps1 | iex

## Set up for a user

1. fyi new --save        # creates a topic (4 words, e.g. maple-orbit-lantern-dune)
2. Tell the user to install the phone app (https://pinged.fyi/app) and join the
   topic: + -> Join -> scan the QR (run "fyi qr") or type the words.
3. Add the MCP server so agents can notify the user:
   claude mcp add fyi -- fyi mcp
   (exposes a send_notification tool: message, title?, priority?)

## Use

fyi "message"                          # publish to the default topic
fyi --title CI --priority high "msg"   # priorities: min | default | high
fyi listen                             # stream incoming messages to stdout

## Raw HTTP API (no CLI needed)

POST https://pinged.fyi/t/{topic}            body = message text
  optional headers: X-Title, X-Priority (min|default|high), X-Tags
GET  https://pinged.fyi/t/{topic}/sse        live stream (SSE)
GET  https://pinged.fyi/t/{topic}/json?since={unix_ms}   48h history

Topic IDs match [A-Za-z0-9_-]{8,64}. Message bodies up to 4 KB.
Rate limits: 60 msgs/topic/hour, 240/IP/hour.