LOCKDOWN FOR MACOS
==================

A study lockdown for macOS 26 on Apple silicon.

INSTALL
-------
1. Unzip the download.
2. Right-click "Install Lockdown.command" and choose Open.
   If macOS refuses, open Terminal in this folder and run:
     bash "Install Lockdown.command"
3. Enter your administrator password when asked. It installs the background
   enforcer and the iPhone Wi-Fi shield.
4. The app opens. Give it Screen Recording permission if you want the focus
   coach to read visible text. Browser automation permission is needed for
   tab URLs.

The first launch may show a Gatekeeper warning because this build is signed
for development, not notarized. Right-click the app and choose Open once.

FOCUS AI
--------
No setup is needed on a Mac that supports Apple Intelligence. The coach runs
on-device through Apple FoundationModels: window titles, browser tabs and
optional screen text stay on the Mac.

If Apple Intelligence is unavailable, Lockdown switches to Gemini and asks
for a key. Create one free at:

  https://aistudio.google.com/app/apikey

Sign in with a Google account, choose Get API key, create a key and paste it
into Lockdown > Settings > General > Focus AI > Cloud. No card is required.
Free-tier limits apply. The key is stored in your macOS Keychain.

There is no bundled or shared key. Every downloader uses their own free key.

IPHONE WI-FI SHIELD
-------------------
Lockdown runs a tiny DNS filter on this Mac. To shield an iPhone on the same
Wi-Fi:
1. Open Lockdown > iPhone.
2. On the iPhone, join the same Wi-Fi.
3. Settings > Wi-Fi > (i) > Configure DNS > Manual.
4. Add the Mac's IP address shown in the app and remove the others.
5. Start a session. The phone's blocked domains stop resolving until the
   timer ends.

The iPhone needs no app, profile or entitlement. Turn the DNS setting back to
Automatic when you are done.

END EARLY
---------
End early requires typing this sentence exactly:

  i am choosing to abandon my study session and i will regret it tomorrow

PRIVACY
-------
No account. No telemetry. No Lockdown server. Rules, timer and logs stay on
the Mac. On-device coaching never leaves the machine. Cloud coaching sends
the active window text to Google's Gemini API with your own key.

UNINSTALL
---------
Run "Uninstall Lockdown.command" and type yes. It removes the app, helper,
DNS daemon, hosts block and browser policies. A hosts backup is written to
/etc/hosts.lockdown-uninstall.bak.

REQUIREMENTS
------------
- macOS 26 or later
- Apple silicon
- Administrator rights for the installer

Source and updates: the download page.