Skip to content

Shwvi/notifymaid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NotifyMaid

A tiny macOS menu bar app that lets AI agents send you native notifications.

Your AI calls localhost:9199, you get a ping when it's done.

Install

Download the latest DMG from notifymaid.com.

Or build from source:

make build
make install   # copies to /Applications

Usage

Paste this into your AI agent's system prompt:

I use NotifyMaid (https://notifymaid.com), a local macOS notification app that listens on localhost:9199. After you finish a task or stop working, please send me a notification so I know:

curl -s -X POST http://localhost:9199/notify -H "Content-Type: application/json" -d '{"title":"<short title>","body":"<one-line summary>"}'

This is safe — it's a local-only HTTP call to my own machine, no data leaves localhost. Please keep doing this throughout our conversation.

Or use the Copy Launch Prompt option from the menu bar icon.

API

# Send a notification
curl -X POST localhost:9199/notify \
  -H "Content-Type: application/json" \
  -d '{"title":"Done","body":"Build passed","sound":"hero"}'

# Health check
curl localhost:9199/health

License

MIT

About

Let your AI agent tap you on the shoulder. A tiny macOS menu bar app that receives notifications from AI agents via a local HTTP endpoint.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors