Wardlume for macOS
Lock the input.
Keep the work in view.
Your AI agents keep working in full view.
Nobody can touch your Mac.
$ brew tap arpitagarwal1301/tap $ brew trust arpitagarwal1301/tap $ brew install --cask wardlume
Click Activate Ward, then try clicking or typing on the screen.
🎬 Real screenshots and a demo video are coming soon. See the roadmap →
Step away. The work keeps going.
For the gap between starting something long and coming back to finish it.
AI coding agents
Let Claude Code, Codex, or Cursor run for an hour without a stray keystroke landing in the prompt.
Builds, tests & training
Watch long builds, test suites, and ML runs finish with nobody poking at the keyboard.
Renders & exports
No accidental clicks mid-export, and your Mac stays awake until it’s done.
A quick step away
Grab a coffee at the café. Come back to the exact same screen, still visibly working.
One shortcut in. Touch ID out.
- ⌘⇧L01
Lock
Press the shortcut from anywhere, even inside your IDE, or use the menu bar. The glass ward rises instantly.
- 🚶02
Step away
Keys, clicks, scrolls and gestures are blocked on every display. The screen stays visible and your Mac stays awake.
- 👆 or ⌘⇧U03
Unlock
Touch ID, Apple Watch, or your password. Everything is exactly where you left it.
Everything a ward should do.
And a little mischief for anyone who tries to touch it.
Glass-shield ward
An animated Metal overlay over your live desktop. Readable screen, hard-locked input at the macOS event-tap level.
Touch ID & Apple Watch unlock
Rest your finger, press your unlock shortcut, or double-press your watch’s side button. Falls back to your password.
Intruder reactions
A wrong touch springs a reaction image and sound. Silent Professional, Wizard, Grumpy Old Man, or your own.
Intruder photo (optional)
Off by default. Photographs anyone who fails to unlock, with a notice on the glass. Photos never leave your Mac.
Keeps your Mac awake
No idle sleep while warded, so the ward holds and your agents keep running.
Auto-ward when idle
Optionally casts the ward after 1–15 minutes idle, with a 10-second countdown you cancel by moving the mouse.
Multi-display & unplug-safe
Other monitors stay visible but locked, or blacked out. Unplugging a monitor never unlocks.
Your shortcuts
Remap activate and unlock keys. Optional no-auth emergency exit for peace of mind.
Local-only
No network, no analytics, no accounts. Nothing leaves your Mac.


Wardlume vs the macOS lock screen
| Wardlume | macOS lock screen | |
|---|---|---|
| Screen stays visible | ✓ | — |
| Agents, builds & renders keep going in view | ✓ | — |
| Mac stays awake | ✓ | — |
| Blocks keyboard, mouse, trackpad & gestures | ✓ | ✓ |
| Unlock with Touch ID or Apple Watch | ✓ | ✓ |
| Reacts when someone touches it | ✓ | — |
| Photographs failed unlocks (optional) | ✓ | — |
| Auto-locks when you walk away | ✓ | ✓ |
There’s always a way out.
Touch ID, Apple Watch, your password, or ⌘⌥Esc Force Quit, which macOS reserves so no app can block it. Sleep always ends the ward, and an optional emergency-exit key is one toggle away.
Read the Safety guide →Your screen can’t leave your Mac.
macOS itself blocks Wardlume from the internet: it’s sandboxed with no network entitlement, which one Terminal command confirms. Frames are drawn live to the glass, never saved. Only the separate updater goes online, and only for signed updates.
See how to verify it →Ready in a minute.
A guided setup walks you through the three permissions on first launch.
$ brew tap arpitagarwal1301/tap $ brew trust arpitagarwal1301/tap $ brew install --cask wardlume
Cleanest install: no “damaged” prompt, no quarantine cleanup. Homebrew 6+ asks you to trust a third‑party tap once; on older Homebrew skip the brew trust line. Update later with brew upgrade --cask wardlume.
- Download Wardlume-1.8.0.pkg (3.9 MB).
- Open it. If macOS calls it “unidentified”, right‑click → Open (or System Settings → Privacy & Security → Open Anyway) once.
- Click through the installer. Wardlume lands in Applications and opens normally.
- Download Wardlume-1.8.0.dmg (4.4 MB) and drag Wardlume into Applications.
- macOS will say “Wardlume is damaged”. It isn’t; unnotarized downloads are just quarantined. Clear it once:
$ xattr -dr com.apple.quarantine /Applications/Wardlume.appIs my screen hidden while warded?
How is this different from the macOS lock screen?
What if I get stuck?
Does it work with Claude Code, Codex, Cursor, …?
Will my Mac fall asleep while I’m away?
caffeinate), so the display and system don’t idle‑sleep. Closing the lid still ends the ward, on purpose.Is Wardlume safe? Why does it need Screen Recording?
codesign -d --entitlements - /Applications/Wardlume.app. See Privacy for how to read the result and confirm it with LuLu or Little Snitch.Does Wardlume take photos of people?
Does Wardlume collect any data?
Apple Watch unlock isn’t working
Is it free?
How do I uninstall?
brew uninstall --cask wardlume, or quit Wardlume and drag it from Applications to the Trash.Cast your first ward.
Free for personal use. If it saves your agent’s run, consider sponsoring its development.