How karim-coder/life-os works
Life OS is a self-hosted personal productivity and knowledge-management app. Users sign in, capture or organize life items, then manage them across planning, reflection, and insight views; the API persists and aggregates this data. The README documents major capabilities beyond the sampled implementation, including focus, calendar, AI inbox processing, and backup/export. Edges are limited to documented product flows and source-index references; several UI-to-API details are not evidenced in the excerpts.
Main entry points: page.tsx Life OS app · db.ts Prisma database · reviews-view.tsx Reviews · quick-capture.tsx Quick capture
Components 23
User experience
- Life OS app
src/app/app/page.tsx - Item detail
src/components/life-os/item-detail-sheet.tsx
Life organization
- Quick capture
src/components/life-os/quick-capture.tsx - Inbox
src/components/life-os/views/inbox-view.tsx - Projects
src/components/life-os/views/projects-view.tsx - Master calendar
src/components/life-os/views/calendar-view.tsx - Focus timer
src/components/life-os/views/focus-view.tsx - Brain graph
src/components/life-os/views/graph-view.tsx
Reflection and insight
- Journal editor
src/components/life-os/views/journal-editor-view.tsx - Reviews
src/components/life-os/views/reviews-view.tsx - Insights dashboard
src/components/life-os/views/insights-view.tsx - Sanctuary
src/components/life-os/views/sanctuary-view.tsx
Application services
- Authentication
src/app/api/auth - Items API
src/app/api/items - Graph API
src/app/api/graph/route.ts - Insights API
src/app/api/insights/route.ts - AI inbox processing
src/app/api/ai/smart-inbox/route.ts - AI provider
src/lib/ai-provider.ts - Backup and export
src/app/api/backup/route.ts
Data and identity
- Prisma database
src/lib/db.ts - Session and TOTP
src/lib/auth.ts - Client view state
src/store/life-os.ts
Other components
- User
Connections 25
- User → Authentication: signs in
README.md - User → Life OS app: uses
README.md - Life OS app → Quick capture: captures items
README.md - Quick capture → Inbox: processes later
README.md - Inbox → AI inbox processing: requests suggestions
README.md - AI inbox processing → AI provider: uses provider
- Life OS app → Item detail: views items
README.md - Life OS app → Projects: organizes projects
README.md - Life OS app → Master calendar: plans dates
README.md - Life OS app → Focus timer: runs focus sessions
README.md - Life OS app → Brain graph: explores connections
README.md - Brain graph → Graph API: loads graph data
- Graph API → Prisma database: reads links and items
src/app/api/graph/route.ts - Life OS app → Journal editor: writes journals
README.md - Life OS app → Reviews: reflects
README.md - Reviews → Client view state: reads view state
src/components/life-os/views/reviews-view.tsx - Reviews → Insights dashboard: tracks progress
README.md - Insights dashboard → Insights API: loads summaries
- Insights API → Prisma database: aggregates records
src/app/api/insights/route.ts - Life OS app → Sanctuary: visits
README.md - User → Backup and export: exports data
README.md - Authentication → Session and TOTP: uses session helpers
- Session and TOTP → Prisma database: reads user data
src/lib/auth.ts - Items API → Prisma database: reads and writes items
src/app/api/items/route.ts - Backup and export → Prisma database: reads data
src/app/api/backup/route.ts