Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MirrorLock

Watch your AI work. Touch nothing.

🌐 Website: shubhransh-gupta.github.io/mirrorLock

MirrorLock is a macOS menu bar app for botsitting — leave your AI coding agents (Cursor, Claude Code, Copilot, etc.) running while you step away. It mirrors your live desktop behind a dimmed overlay and hard-locks keyboard, mouse, and trackpad at the macOS event-tap level. The screen stays fully visible so anyone can watch the agent work, but nothing can be touched. Unlock instantly with Touch ID.

Inspired by the concept of Wardlume, rebuilt from scratch with a simpler architecture and MIT license.

Features

  • Live mirror overlay — your desktop stays visible behind a subtle dimmed layer via ScreenCaptureKit
  • Hard input lock — keyboard, mouse, trackpad, scroll, and media keys blocked via CGEventTap
  • Touch ID unlock — rest your finger or use your password to unlock
  • Intruder alerts — wrong touches trigger a red border flash and alert sound
  • Multi-display aware — secondary screens are blacked out while locked
  • Global hotkeys — activate and unlock from anywhere, even while focused in your IDE
  • Local-only — no network, no analytics, no accounts

How MirrorLock differs

Wardlume MirrorLock
Visual Metal glass-shield shader Live desktop mirror + dim overlay
Hotkey ⌘⇧L ⌘⇧M
Reactions Character packs with images/sounds Border flash + system sound
Onboarding PermissionPilot SDK Built-in settings panel
License PolyForm Noncommercial MIT
Min macOS Tahoe 26+ Sonoma 14+

Usage

  1. Launch MirrorLock — it lives in your menu bar.
  2. Press ⌘⇧M from anywhere to activate the mirror lock.
  3. Walk away. The screen stays visible; input is locked.
  4. Return and rest your finger on Touch ID — or press ⌘⇧U — to unlock.

Permissions

MirrorLock needs three permissions, used only while the lock is active:

Permission Why
Screen Recording Mirrors your live desktop behind the overlay
Accessibility Locks keyboard, mouse, and trackpad
Input Monitoring Detects intrusion attempts

Grant them in Settings → Permissions inside the app, or via System Settings → Privacy & Security.

Quick install

One command — downloads the latest release, installs to /Applications, and launches:

curl -fsSL https://raw.githubusercontent.com/shubhransh-gupta/mirrorLock/main/scripts/install.sh | bash

Or download manually from Releases.

Build from source

Requires Xcode 16+ on macOS 14+.

git clone https://github.com/shubhransh-gupta/mirrorLock.git
cd mirrorLock
open MirrorLock.xcodeproj

Select the MirrorLock scheme and press ⌘R.

Built with Swift, SwiftUI, AppKit, and ScreenCaptureKit.

Website

The marketing site lives in docs/. Enable GitHub Pages under Settings → Pages → Deploy from branch → /docs on main to publish at https://shubhransh-gupta.github.io/mirrorLock.

Preview locally: open docs/index.html in a browser.

App icon

Icons are generated from scripts/generate_icon.py:

pip3 install -r scripts/requirements.txt
python3 scripts/generate_icon.py

License

MIT — use it however you like.

About

Lock your Mac so people can watch your AI agent work but can't touch it. Touch ID to unlock. Inspired by Wardlume, built your way.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages