Knock once, and your phone buzzes.
Knockbox turns one HTTP request into a push notification on your iPhone. Anything that can send a request can reach you: a deploy script, a cron job, a monitoring check, a CI pipeline, or a coding agent that has just finished a long task. If it needs your go-ahead before continuing, it can wait for your answer.
curl -d "Build finished" https://your-server/api/v1/send/YOUR_TOKEN
THE SERVER IS YOURS
Knockbox is the client for a server you control. The server is open source and runs on a VPS, a NAS, or a Raspberry Pi at home. It holds its own Apple push key, so a notification goes from your machine to Apple and then to your phone, without passing through anyone in between. If you would rather not run anything, you can pair with a public instance by scanning its QR code.
WHAT A MESSAGE CAN CARRY
• A Markdown body with headings, lists, links and syntax-highlighted code.
• Images, shown in the notification and kept with the message.
• Long text. The body is fetched as the notification lands rather than packed into it, so there is no length limit to work around.
• A title, a channel, and an interruption level: quiet, normal, or time sensitive when it has to break through Focus.
REPLIES
• The sender can attach a set of options, or allow a free-text answer.
• Answer from the message itself. Your server posts the reply back to the address the sender gave, signed, and the sender takes it from there.
• The sender can set a deadline. After it passes the message reads "Reply window closed" and the server stops accepting — you are never left thinking an answer went through.
• A message is answered once, and the answer is the same across your devices.
CHANNELS
• One token per channel, so a noisy monitor and a personal reminder stay apart.
• Muting a channel truly stops it: the mute lives on the server, so nothing is sent at all.
• Search your history, mark as read, delete a message, or clear a channel. Deletions are real, on the device and on the server.
MORE THAN ONE DEVICE
Pair a second iPhone or iPad from a device that is already connected. Both receive everything and share read state.
TRY IT WITHOUT A SERVER
Demo mode fills the app with example messages and sends a sample notification, so you can see how it works before setting anything up.
FREE, AND THAT IS ALL
No ads, no analytics, no account with us, no in-app purchase, no subscription. The app is free and the server is open source.
Questions: info@miramiao.com
Show more
