Kukuroo es un worker autohospedado que convierte cualquier endpoint HTTP en un sistema de notificaciones push nativas para iOS, sin necesidad de publicar una aplicación en la App Store ni pagar la cuota anual de 99 dólares de Apple. Funciona exclusivamente sobre Cloudflare Workers combinado con una namespace de KV, de modo que el usuario no tiene que mantener infraestructura propia: no hay contenedores, binarios ni servidores que renovar. Las claves criptográficas permanecen en el worker y el payload se cifra extremo a extremo hacia el dispositivo, de forma que ningún panel intermedio —ni el de Kukuroo— ve el contenido de las alertas.
La consecuencia práctica es que cualquier agente, cron, pipeline de CI, Raspberry Pi, backend o alias de shell capaz de realizar una llamada HTTP puede enviar un aviso a la pantalla de bloqueo mediante una única petición POST al endpoint /push/send, autenticada con un token Bearer. Kukuroo confía en las notificaciones web declarativas, una funcionalidad que Safari soporta de forma nativa desde iOS 18.4 y macOS Safari 18.5: la página web debe estar instalada en la pantalla de inicio y abrirse desde su icono, una restricción impuesta por Apple.
El despliegue se realiza con un único comando (npx kukuroo init my-push) que genera claves, provisiona el almacenamiento y publica el worker en menos de un minuto. Si el usuario ya dispone de un worker que sirve su sitio web, Kukuroo se monta en el enrutador existente y los dispositivos se registran bajo el mismo dominio al que debe llegar la notificación al tocarla. El plan gratuito de Cloudflare admite hasta 50 dispositivos por envío y 100.000 peticiones diarias, suficiente para un uso personal; el plan de 5 dólares mensuales amplía esos límites a 10.000 dispositivos por envío y 10 millones de peticiones. El proyecto solo es compatible con Safari: otros navegadores son rechazados en la página de registro en lugar de ofrecer un soporte parcial.