https://github.com/rahullath/messyos
let artificial intelligence and a clean UI fix your fucked up life
https://github.com/rahullath/messyos
anthropic astrojs content-management-system finance-management financial-analysis habits-tracking healthcare-application javascript llm python supabase task-manager together-ai typescript vercel
Last synced: 3 months ago
JSON representation
let artificial intelligence and a clean UI fix your fucked up life
- Host: GitHub
- URL: https://github.com/rahullath/messyos
- Owner: rahullath
- Created: 2025-06-05T19:29:19.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-03T19:52:40.000Z (10 months ago)
- Last Synced: 2025-09-03T21:36:53.305Z (10 months ago)
- Topics: anthropic, astrojs, content-management-system, finance-management, financial-analysis, habits-tracking, healthcare-application, javascript, llm, python, supabase, task-manager, together-ai, typescript, vercel
- Language: TypeScript
- Homepage: https://messy-os.vercel.app
- Size: 2.23 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MeshOS
MeshOS is an executive-function support app.
It is built to help people move through daily life when task initiation, sequencing, transitions, and recovery are hard.
This is not a productivity theater app. The goal is not output-maxing. The goal is daily stability.
## What MeshOS Is
- A practical scaffold for executive function
- Chain-first planning around real anchors and constraints
- A system for reducing ambiguity and transition friction
- User-controlled structure with manual override
## What MeshOS Is Not
- Not an AI life coach
- Not a crypto or finance product
- Not a habit-streak gamification app
- Not a surveillance/self-optimization loop
## Core Principles
- Clarity over optimization
- Chain integrity over punctual perfection
- Recovery over guilt spirals
- User agency over automation lock-in
- Privacy and user ownership of data
## Current Product Scope (V2.2 Stabilization)
### In active use
- Daily Plan
- Chain view
- Exit-gate flow
- Manual anchors
- Chain step editing and persistence
- Habits
- Import + dedupe + merge correctness
- Daily logging and streak context
- Account / Settings baseline
- Profile, subscription shell, and usable settings
### In progress
- Collapse Mode (recovery-first mode when day execution breaks)
- Mobile UX hardening on core screens
- PWA install/offline baseline improvements
### Out of scope for current stabilization pass
- Finance module redesign
- Health module expansion
- Content/recommendation module buildout
These modules may appear in the repo but are not part of the current reliability target.
## Who MeshOS Is For
People who:
- Struggle to start tasks
- Freeze under ambiguity
- Lose the day after one disruption
- Need structure without rigid productivity culture
- Identify with ADHD traits, autistic traits, chronic overwhelm, or executive dysfunction patterns
## Product Direction
MeshOS is being shaped as an executive-function prosthetic layer:
- Useful in chaos, not only on perfect days
- Additive and minimal-risk implementation
- Recovery pathways (not failure screens)
- Support that can be reduced over time, not dependency by design
## Technical Stack
- Frontend: Astro + React + TypeScript + Tailwind CSS
- Backend: Astro API routes
- Database/Auth: Supabase (PostgreSQL + RLS)
- Deployment: Vercel
## Local Development
### Prerequisites
- Node.js 18+
- npm
- Supabase project
### Setup
1. Install dependencies:
```bash
npm install
```
2. Configure environment variables in `.env` (Supabase and any optional providers).
3. Run migrations against your Supabase database.
4. Start dev server:
```bash
npm run dev
```
## Security Baseline
- Auth required on protected APIs
- `user_id` derived from server session, never trusted from client payload
- User-scoped queries on data access
- RLS enabled on touched tables
## Status
MeshOS is under active stabilization and iteration.
The current objective is a reliable, multi-user-safe core experience for:
- Daily Plan
- Habits
- Settings / account basics
Once this is stable, additional modules and SEO/content expansion will follow.