Skip to content

Repository files navigation

Reclaim

License Platform Status

An attention management app for Android.

Reclaim helps you come back to content you intentionally saved — instead of losing that time to whatever an algorithm decides to recommend next.

Share → Save → Appropriate Moment → Consume

You share a link to Reclaim the moment you find something worth reading or watching. Later, when you open an app that tends to eat your attention, Reclaim gently offers you what you actually meant to get to.


What this is not

Reclaim is deliberately not:

  • a bookmark manager
  • a task manager
  • gamified — no streaks, no scores, no habit tracking
  • a place for infinite collection

The full reasoning behind these boundaries lives in VISION.md and DECISIONS.md — worth reading before opening a PR that adds any of the above.


Features

  • 📥 Save anything via the Android Share Sheet — no separate save button to add to every app
  • 🏷️ Automatic classification — article vs. video, source domain
  • 📝 Best-effort metadata — title, author, and estimated reading time, fetched once at save time
  • A real list, not a graveyard — tap to open, swipe to mark consumed
  • 🔔 Attention engine — detects when you open a supported app (YouTube, Instagram, X, Reddit) and nudges you toward saved content instead, with a blurred-background overlay and zero pressure to say yes

Not yet built

  • Snooze / skip reminders (distinct from simple dismiss)
  • User-customizable list of "supported apps" and polling interval
  • Video duration display for YouTube saves
  • Content-topic categorization
  • Google Play release (see DECISIONS.md for why this isn't the near-term goal)

Tech stack

Language Kotlin
UI Jetpack Compose + Material 3
Persistence Room (local-first, no accounts, no cloud sync)
HTML metadata Jsoup
Build AGP 8.13.2, Kotlin 2.3.10, Gradle 8.13

The AGP/Kotlin plugin combination is a deliberate, documented choice — see the Technology section of DECISIONS.md before changing it.


Getting started

Install the APK

Grab the latest signed build from the Releases page and sideload it — no Play Store required.

Build from source

git clone <this-repo-url>
cd Reclaim
./gradlew build
./gradlew testDebugUnitTest

Requires the current stable Android Studio and a device/emulator on API 26+.

The attention engine needs two permissions granted manually via system Settings (there's no runtime dialog for either — the app links you to the right screen for each):

  • Usage Access, to detect which app is in the foreground
  • Display over other apps, to show the nudge overlay

Contributing

PRs welcome — please read CONTRIBUTING.md first. This project is built one small, independently-buildable ticket at a time, and that discipline is part of what keeps it maintainable — PRs are reviewed with that in mind.

License

Apache License 2.0 — see LICENSE.

Releases

Packages

Contributors

Languages