Getting started
Install Wardlume, finish the guided setup, and cast your first ward.
Wardlume is a menu-bar app that locks your Mac’s keyboard, mouse, and trackpad behind a see-through shield while everything on screen keeps running in view. It’s made for botsitting: leaving an AI coding agent (Claude Code, Codex, Cursor, …) working while you step away.
1. Install
The cleanest way is Homebrew:
brew tap arpitagarwal1301/tap
brew trust arpitagarwal1301/tap
brew install --cask wardlume
Prefer a regular download? See Download for the .pkg and .dmg.
2. Finish the guided setup
On first launch, a setup window asks for two permissions, Accessibility and Input Monitoring, plus two optional ones you can skip (Screen Recording for the Live glass look, Camera for Intruder photo), one at a time. Each one deep-links to the right System Settings pane and checks itself off live as you grant it. Some grants only apply after a relaunch, so the wizard offers Quit & Reopen when needed.
Why each permission is needed: Permissions.
3. Cast your first ward
- Press ⌘⇧L from anywhere, even while typing in your IDE, or choose Activate Ward from the menu-bar icon.
- The see-through “Input locked” screen rises over your displays. The screen stays readable; input is locked. Prefer the animated refracting glass? Pick Live glass in Settings → Overview → Ward look.
- Walk away. Your Mac stays awake, so the ward holds and your agent keeps running.
4. Unlock
- Touch ID: rest your finger on the sensor, or press ⌘⇧U and then use Touch ID.
- Apple Watch: tap any key, then double-press the watch’s side button (set it up).
- Password: press ⌘⇧U, then choose Use Password….
Stuck? ⌘⌥Esc → Force Quit Wardlume always works, because macOS reserves that shortcut. See the Safety guide.
Next
- Pick your intruder reaction: Intruder reactions
- Auto-ward when idle and launch at login: Automation
- Multiple monitors: Displays & gestures
Something unclear or out of date? Tell us in Discussions.