WHEN YOUR AGENT NEEDS YOU

BREAK
THROUGH.

Your AI agent has no way to interrupt you. System notifications get ignored. DND wins. Knok doesn't care.

DOWNLOAD FOR MACOS VIEW ON GITHUB
Open source · MIT license
01 /

FOUR LEVELS OF URGENCY

01 WHISPER

A quiet notification. No response needed.

fades on its own
02 NUDGE

A banner that stays until you respond.

waits for you
03 KNOCK

Sound + overlay. Your agent needs you now.

loud · on top
04 BREAK

Full-screen takeover. Every display. Must respond.

total takeover
02 /

HOW IT WORKS

STEP 01

AGENT HITS A WALL

It needs a decision. System notifications get swallowed. DND blocks everything.

STEP 02

KNOK BREAKS THROUGH

A native macOS window appears. Bypasses DND, Focus mode, and full-screen apps.

STEP 03

YOU RESPOND. IT CONTINUES.

Click a button. Your agent gets the answer and keeps going.

03 /

HOW YOUR AGENT CAN CONNECT

MCP SERVER Claude Code · Cursor

One line in your MCP config. Your agent calls knok like any other tool.

CLI Any script, any language

Run knok from bash, Python, or Node. Exit code tells you what was clicked.

UNIX SOCKET Direct integration

Send JSON, get the human's response. Any language that speaks sockets.

CLAUDE CODE SKILL Drop-in skill file

Drop SKILL.md into your project. No install, no config.

↓ DOWNLOAD SKILL.MD
or npx skills add TomasWard1/knok
04 /

WHAT YOUR
AGENT CAN DO

01

Add action buttons

Give humans choices. Get their exact answer back as a string.

02

Choose the urgency

Four levels — from a quiet tap to full-screen takeover.

03

Make it speak

TTS reads your message out loud. Pure audio interruption.

04

Set a timeout

Auto-dismiss after N seconds. Workflow keeps moving.

05

Cover every screen

Break level blankets all connected displays.

YOUR AGENT
IS WAITING.

Give it a voice.

DOWNLOAD KNOK — FREE