Open source · Local first · No telemetry

Know exactly when your agents need you.

AgentNotify turns permissions, questions, blockers, failures, and completions into durable human-attention requests—then routes them to the surfaces you already use.

Download latest release Read the documentation

Windows has the full graphical app. macOS and Linux currently run the CLI and headless broker.

agentnotify

broker online

$ agentnotify send \
  --type permission_required \
  --title "Deploy approval" \
  --message "May I publish the release?"

Deploy approval

Codex needs permission · release

high

Persisted locally before optional delivery

666

automated tests

outbound adapters

supported OS families

telemetry services

Why AgentNotify

A broker for the human bottleneck.

Agents can work for hours without help. The costly moment is when one silently stops at a permission prompt, missing credential, or decision only you can make.

Local source of truth

SQLite keeps unresolved state, deduplication keys, history, and delivery attempts on your machine.

Route after persistence

Desktop delivery is authoritative. Optional remote channels run later through a durable outbox.

Explicit trust boundary

The API stays on loopback behind a random bearer token. External channels are disabled until configured.

ARC 0.1

One contract for attention.

The Attention Request Contract is an open JSON contract for creating, updating, and resolving bounded requests for human attention. It separates an immutable event from the condition that remains unresolved.

Read the specification JSON Schema

{
  "arc_version": "0.1",
  "event_id": "evt_release_42",
  "event_type": "request.created",
  "occurred_at": "2026-08-26T01:15:00Z",
  "sender": { "id": "codex", "name": "Codex" },
  "request": {
    "key": "release-approval",
    "kind": "permission",
    "message": "May I publish the release?",
    "priority": "high"
  }
}

Delivery

Your attention, where you want it.

Every remote destination is opt-in. Credentials are encrypted at rest, payloads are bounded, and provider failures never reject the local request.

Explore channels

DesktopSMTPTelegramDiscordSlackTeamsZoho CliqGoogle ChatMattermostMatrixntfyGotifyPushoverPushbulletTwilioWhatsAppMQTTWebhook

Architecture

Simple at the boundary. Durable underneath.

Coding agents

CLI · ARC · future adapters

Loopback API

Bearer auth · validation

Local lifecycle

SQLite · dedup · history

Attention routes

Desktop · chat · mail · push

Stop checking every terminal.

Install AgentNotify, give your coding agent the bundled skill, and let the broker tell you when human attention is actually required.

Download release View source