hark logo

hark

A simple, beautiful webhook to notification platform.

NotficationsDeveloper ToolsTypeScriptNOASSERTION 129 10Health 78
Website GitHub

What is it?

What it is

A webhook-to-iOS notification service that converts HTTP requests into branded iPhone notifications, Live Activities, and interactive agent workflows.

Why it exists

To provide a simple way for CI jobs, scripts, monitoring tools, and AI agents to communicate status, request approvals, and show real-time task progress via iPhone's Lock Screen and Dynamic Island.

Who should use it

Developers wanting to send rich iOS notifications via webhooksDevOps engineers monitoring CI/CD pipelinesAI agent developers looking to integrate mobile notifications and approvalsSystem administrators needing real-time status updates on iPhoneUsers wanting to use iOS Live Activities for task progress tracking

Who should avoid it

Users looking for a purely open-source license (it is source-available/non-commercial)Commercial enterprises requiring free usage (requires separate license)Android users (iOS specific features like Live Activities and Dynamic Island)

How it works

A quick walkthrough in plain English

How hark works

Step 1 of 3

You interact with it

Open hark, send a request, or connect it to your stack.

Features

Rich iOS notifications via simple webhooks
Live Activities support for Lock Screen and Dynamic Island
Interactive approvals and text replies for agent workflows
Service branding with custom names and avatars
Web dashboard for tracking delivery and devices
CLI tool (harkctl) for scriptable notifications and activity management
Agent skill compatibility (OpenCode, Claude Code, Cursor, etc.)
Idempotency support to prevent duplicate notifications

Advantages

  • Transforms simple HTTP requests into high-quality mobile alerts
  • Provides real-time task progress visibility through stateful Live Activities
  • Enables bidirectional communication (approvals/replies) from mobile to scripts/agents
  • Easy integration with CI/CD, monitoring tools, and AI agents
  • Supports targeted delivery to specific devices via Pro features

Disadvantages

  • Non-commercial license restricts business usage
  • Requires Node.js 22 or newer
  • Live Activities are limited to one active task per device

Installation

cloud

npx skills add R44VC0RP/hark --skill hark --global

native

npm install -g harkctl

FAQ

What are the system requirements to get started with Hark?

You need Node.js version 22 or newer installed on your system to use the CLI and install the Hark skill.

How can I prevent duplicate notifications if a request fails?

When retrying requests, you should include an 'Idempotency-Key' header to ensure that duplicate notifications are not sent.

Can I use Hark to track long-running tasks on my iPhone?

Yes, Hark supports Live Activities that show stateful task progress (status, progress, etc.) on your Lock Screen and Dynamic Island.

Is there a way to interact with notifications via my agent?

Yes, Hark supports interactive workflows where agents can request approvals or text replies directly through notifications.

What is the difference between a standard notification and a Live Activity?

Standard notifications are one-shot alerts, while Live Activities are stateful and allow for real-time progress updates on the Lock Screen and Dynamic Island.

Can I target specific devices with my notifications?

Yes, using Hark Pro, you can use the 'deviceIds' field in your JSON request to perform targeted delivery to specific devices.

Loading documentation…
View on GitHub

Featured in Videos

YouTube tutorials and walkthroughs for hark

Alternatives

Similar projects ranked by category, topics, and text overlap.

Compare
hark | MushyBook