Repository navigation
Releases
grod 0.6.0
What's new
- Packs instead of Urgent (Android). The pause screen offers a pack: a few minutes without scroll pauses, for a chat that cannot wait. There are only a few (5 × 5 minutes to start) until they are refilled at the weekly review, so each one is a choice. When a pack ends, the next pause comes with the next scroll.
- Scroll pauses keep coming (Android). A pause screen started right as the previous one closed could fail to show, and then no pause came until grod restarted. A screen that does not come up within 5 seconds no longer holds scrolling.
Install
Android (Android 8+)
- Download
grod-<version>.apkbelow and open it on the phone. Allow installing from your browser or file manager when asked. - Open grod and follow the checklist at the top: turn on the grod accessibility service, then notification access, Do Not Disturb access and usage access.
- On Android 13 and newer, the accessibility switch is greyed out for sideloaded apps at first. Go to Settings → Apps → grod → ⋮ → Allow restricted settings, then try again.
- Optional: in the app, set a rules URL (for example the raw link to your own
grod.rules.json) so rule changes reach the phone without a cable.
Browser (Chrome, Comet, Arc, Brave, Edge)
- Download
grod-extension-<version>.zipand unzip it. - Open
chrome://extensions, turn on Developer mode, click Load unpacked and pick the unzipped folder.
macOS menu bar app, CLI and the AI-agent workflow: clone the repository and follow the README.
Signed with the grod release key. Updates install over the previous version.
grod 0.5.1
What's new
- Urgent is no longer a reflex (Android). The pause screen offers "Urgent" only after it has been up for 20 seconds, and an urgent pass lasts 2 minutes of scrolling; then the next pause comes, with its wait.
Install
Android (Android 8+)
- Download
grod-<version>.apkbelow and open it on the phone. Allow installing from your browser or file manager when asked. - Open grod and follow the checklist at the top: turn on the grod accessibility service, then notification access, Do Not Disturb access and usage access.
- On Android 13 and newer, the accessibility switch is greyed out for sideloaded apps at first. Go to Settings → Apps → grod → ⋮ → Allow restricted settings, then try again.
- Optional: in the app, set a rules URL (for example the raw link to your own
grod.rules.json) so rule changes reach the phone without a cable.
Browser (Chrome, Comet, Arc, Brave, Edge)
- Download
grod-extension-<version>.zipand unzip it. - Open
chrome://extensions, turn on Developer mode, click Load unpacked and pick the unzipped folder.
macOS menu bar app, CLI and the AI-agent workflow: clone the repository and follow the README.
Signed with the grod release key. Updates install over the previous version.
grod 0.5.0
What's new
- The scroll pause can't be skipped (Android). Going Home or to Recents and back brings the pause back with the time it had left.
- Urgent (Android). The pause screen offers "Urgent" for when you really need the app now. It opens at once, then asks every 30 seconds of scrolling whether it is still urgent, so you see how long "just this" took.
- Night hours. From 00:00 to 06:00 (configurable) every answer to the opening check waits, Message too.
- A quieter home screen. Only apps you opened in the last 7 days are shown, most used first; the rest are a search away. Search by voice with the microphone.
- Dock. A fixed bottom row for the apps you need every day, drawn with their own logos in one color.
- Uninstall suggestions. Apps you installed and haven't opened for 30 days are listed in the grod app's Apps tab, one tap to uninstall or keep.
Install
Android (Android 8+)
- Download
grod-<version>.apkbelow and open it on the phone. Allow installing from your browser or file manager when asked. - Open grod and follow the checklist at the top: turn on the grod accessibility service, then notification access, Do Not Disturb access and usage access.
- On Android 13 and newer, the accessibility switch is greyed out for sideloaded apps at first. Go to Settings → Apps → grod → ⋮ → Allow restricted settings, then try again.
- Optional: in the app, set a rules URL (for example the raw link to your own
grod.rules.json) so rule changes reach the phone without a cable.
Browser (Chrome, Comet, Arc, Brave, Edge)
- Download
grod-extension-<version>.zipand unzip it. - Open
chrome://extensions, turn on Developer mode, click Load unpacked and pick the unzipped folder.
macOS menu bar app, CLI and the AI-agent workflow: clone the repository and follow the README.
Signed with the grod release key. Updates install over the previous version.
grod 0.4.0
What's new
- Opening check (Android). When Instagram or another distracting app opens after 5 minutes away, by any route, one tap says what for: Message, Look something up or Browse. Quick purposes open at once with a time window grod learns from your own sessions; one that keeps running over loses its quick open; Browse waits first, longer with each Browse that day. It replaces the launcher's fixed pause.
- A calmer grod app. Four tabs (Today, Notifications, Apps, Settings) with Lucide icons.
- Notification history on the phone. Every notification with its full text, one line per chat message or email; search and an app filter; swipe a row to delete it, or delete a whole app, conversation, day or everything.
- Notifications five times a day by default: 08:30, 12:30, 15:30, 18:30, 21:30.
- Wallpapers for phone and desktop on the website.
Install
Android (Android 8+)
- Download
grod-<version>.apkbelow and open it on the phone. Allow installing from your browser or file manager when asked. - Open grod and follow the checklist at the top: turn on the grod accessibility service, then notification access, Do Not Disturb access and usage access.
- On Android 13 and newer, the accessibility switch is greyed out for sideloaded apps at first. Go to Settings → Apps → grod → ⋮ → Allow restricted settings, then try again.
- Optional: in the app, set a rules URL (for example the raw link to your own
grod.rules.json) so rule changes reach the phone without a cable.
Browser (Chrome, Comet, Arc, Brave, Edge)
- Download
grod-extension-<version>.zipand unzip it. - Open
chrome://extensions, turn on Developer mode, click Load unpacked and pick the unzipped folder.
macOS menu bar app, CLI and the AI-agent workflow: clone the repository and follow the README.
Signed with the grod release key. Updates install over the previous version.
grod 0.3.0
What's new
- Scroll pause. Scroll for a minute in Instagram, YouTube, TikTok, X, LinkedIn, Facebook or Snapchat, on the phone or in the browser, and a pause screen makes you wait 10 seconds or leave. Each pause is twice as long as the last, up to 5 minutes; 15 minutes without scrolling starts over. Tune it from the Mac app's Settings or by telling your agent.
- grod cannot read your screen. The Android service only learns that you scrolled and in which app; window content access is off.
- Simpler rules. A rule is an app's Android packages and its websites. Reels/Shorts screen detection, CSS hiding and grod's YouTube channel blocking are gone; use YouTube's own Don't recommend channel instead.
- Screen time counts one app at a time and stops when the screen turns off.
Install
Android (Android 8+)
- Download
grod-<version>.apkbelow and open it on the phone. Allow installing from your browser or file manager when asked. - Open grod and follow the checklist at the top: turn on the grod accessibility service, then notification access, Do Not Disturb access and usage access.
- On Android 13 and newer, the accessibility switch is greyed out for sideloaded apps at first. Go to Settings → Apps → grod → ⋮ → Allow restricted settings, then try again.
- Optional: in the app, set a rules URL (for example the raw link to your own
grod.rules.json) so rule changes reach the phone without a cable.
Browser (Chrome, Comet, Arc, Brave, Edge)
- Download
grod-extension-<version>.zipand unzip it. - Open
chrome://extensions, turn on Developer mode, click Load unpacked and pick the unzipped folder.
macOS menu bar app, CLI and the AI-agent workflow: clone the repository and follow the README.
Signed with the grod release key. Updates install over the previous version.
grod 0.2.0
What's new
- grod launcher (Android): a calm home screen. Clock, date and search on top; the apps you used in the last 14 days as a word cloud sized by use. Distracting apps stay small and open after a short pause you can back out of.
- Nothing on screen is darkened. Tabs and thumbnails stay as the app draws them; grod leaves a Reels or Shorts feed the moment it opens.
- One reel at a time for a reel someone sends you, your own reels and reels from accounts you follow. Opening one no longer bounces right back; swiping to the next one does.
- Screen time counts one app at a time and stops when the screen turns off, so weekly reviews no longer show hours of an app that was closed.
- Wireless adb: the CLI and the macOS app reconnect to the phone's saved Wi-Fi address on their own.
Install
Android (Android 8+)
- Download
grod-<version>.apkbelow and open it on the phone. Allow installing from your browser or file manager when asked. - Open grod and follow the checklist at the top: turn on the grod accessibility service, then notification access, Do Not Disturb access and usage access.
- On Android 13 and newer, the accessibility switch is greyed out for sideloaded apps at first. Go to Settings → Apps → grod → ⋮ → Allow restricted settings, then try again.
- Optional: in the app, set a rules URL (for example the raw link to your own
grod.rules.json) so rule changes reach the phone without a cable.
Browser (Chrome, Comet, Arc, Brave, Edge)
- Download
grod-extension-<version>.zipand unzip it. - Open
chrome://extensions, turn on Developer mode, click Load unpacked and pick the unzipped folder.
macOS menu bar app, CLI and the AI-agent workflow: clone the repository and follow the README.
Signed with the grod release key. Updates install over the previous version.
grod 0.1.0
Install
Android (Android 8+)
- Download
grod-<version>.apkbelow and open it on the phone. Allow installing from your browser or file manager when asked. - Open grod and follow the checklist at the top: turn on the grod accessibility service, then notification access, Do Not Disturb access and usage access.
- On Android 13 and newer, the accessibility switch is greyed out for sideloaded apps at first. Go to Settings → Apps → grod → ⋮ → Allow restricted settings, then try again.
- Optional: in the app, set a rules URL (for example the raw link to your own
grod.rules.json) so rule changes reach the phone without a cable.
Browser (Chrome, Comet, Arc, Brave, Edge)
- Download
grod-extension-<version>.zipand unzip it. - Open
chrome://extensions, turn on Developer mode, click Load unpacked and pick the unzipped folder.
macOS menu bar app, CLI and the AI-agent workflow: clone the repository and follow the README.
Signed with the grod release key. Updates install over the previous version.