hermes atlas
318·repos hermes·v0.23.1 ★ star this repo

EntangledQuantum/Life_OS

ADHD-friendly personal execution OS: habits, study blocks, agent control (Hermes/MCP), local SQLite

★ 40 langTypeScript updated2026-11-10

Life OS is a personal app where an AI agent creates and maintains habits, schedules tasks, tracks goals, and adjusts plans based on what happened. Users tap to complete items, while data stays in a local SQLite file with no account or cloud sync.

  • Habits recur and are scored daily; tasks cover other activities.
  • Includes an Android client and connects to agents over MCP.
  • Runs locally and stores data in SQLite.
full readme from github

Life OS

Let AI agent manage your life · habits · health · study · goals · sleep

Your agent designs the system and keeps it up to date. You just tap to complete.

🌐 Website  ·  📱 Android app  ·  📖 Docs

Runs on your machine · no account · Node 22.5+ · SQLite · MIT


The Life OS dashboard


Goals, each with its rarity ladder

Life OS on Android — Today, the growth meter and the day as one list Life OS on Android — Day, the ribbon and what still needs you Life OS on Android — You, goals and the last seven days

Set it up

Paste this at any agent that can read a URL and run commands:

Fetch https://raw.githubusercontent.com/EntangledQuantum/Life_OS/master/docs/AGENT_SETUP.md and set Life OS up for me

It will install it, run it as a service, connect over MCP, interview you about your actual day, and schedule its own nightly check-in. Prefer to do it yourself? docs/AGENT_SETUP.md is readable by humans too, and pnpm setup && pnpm dev is the short version.


What it is, and why you'd want it

Most habit apps assume the hard part is doing the thing. For a lot of people it isn't. The hard part is designing and maintaining the system — deciding what to track, noticing a habit has quietly died, re-slicing the day when something stops working, remembering to review any of it. That is the part that collapses first, and once it does, the app becomes another thing you're failing at.

So Life OS splits the job in two:

  • You do the doing. Tap to complete. That is the entire interface.
  • Your agent does the designing. It creates the habits, schedules the day, writes the goals, watches what actually happened, and adjusts.

Everything lives in one SQLite file on your own machine. There is no account, no cloud, no sync, and no way for anyone to see your data — including us.

Two nouns, and that's the whole model:

  • Habits — recur, scored daily.
  • Tasks — everything else: scheduled work, reminders, reviews, study blocks, the cards on your front page. One kind of thing with optional parts.

A few deliberate refusals: no levels, no ranks, no leaderboards, no streak guilt, and nothing on the screen ever turns red because you had a bad day. XP measures today against today's target and nothing else.


What it looks like in use

Your agent notices a pattern.

"You've skipped the 07:00 reading block four days running. Moving it to 21:30 — you finished it every time it was there last month."

You're studying something. Your agent schedules a study task with the chapter, the instructions, and links to the PDF and a video. All of it shows up on your phone at the right time. You read it, you tap done, the minutes are recorded.

Something happens on the agent's side. It finishes processing a book you read, increments books_read, and the goal you set in January — read 20 books — ticks forward on its own. When it completes, the dashboard plays the celebration. The goal isn't finished until you've seen it.

You want to be told when something is done. Your agent subscribes to a webhook and hears about every completion the moment it happens, instead of asking every five minutes.


Contributing

Issues and PRs welcome. It is a pnpm workspace: apps/api (Hono), apps/web (React) and packages/{db,shared,mcp}, plus mobile-frontend/native-android — the Android client, Kotlin and Jetpack Compose, built with the Android SDK command-line tools and Gradle. It is deliberately isolated: it is not in the pnpm workspace, it must never import from apps/* or packages/*, and its only contact with the rest of the repo is HTTP to the API. mobile-frontend/app is the retired Expo client, kept until the native one has been in daily use for a while.

pnpm install
pnpm setup      # .env, database, seed data
pnpm dev        # api + web
pnpm test       # every package
pnpm typecheck

Before opening a PR: pnpm typecheck && pnpm test, and in mobile-frontend/native-android, ./gradlew assembleDebug assembleRelease test lint if you touched the Android app. Build the release variant too, not just debug: Android permits cleartext HTTP in debug builds automatically, so a release-only networking failure is invisible until someone installs an APK. Database changes go in packages/db/src/migrations.ts as a new numbered migration — never edit a shipped one.

Full docs, the API reference and the agent skill are on the website and under docs/.


License

MIT — do what you like with it.


Built for a brain that does the work but hates maintaining the system.