Italiano · English · Architecture · Roadmap · Launch Checklist · Changelog
LifeOS is a local-first, zero-cloud personal operating system for your administrative life. It consolidates personal identity documents, vehicle papers, insurance policies, statutory warranties, and bureaucratic multi-step procedures into a deterministic, private JSON vault with iCalendar feed exports and offline HTML reports.
Personal administration and civil deadlines are dangerously fragmented:
- Scattered Across Multiple Channels: Passports, driver's licenses, lease renewal terms, and insurance policies are buried across email folders, paper binders, and disjointed apps.
- Missed Cancellation & Renewal Deadlines: Unnoticed 60-day or 6-month notice windows lead to unintended contract renewals or invalid travel documents when booking trips.
- Unclaimed Warranties: Consumer goods receipts fade away, causing owners to pay out of pocket for repairs legally covered under the 24-month statutory warranty.
- Chaotic Bureaucracy: Multi-step administrative tasks (passport application, residency change, tax declarations) lack unified step-by-step checklists and tracking.
- Privacy Invasion: Cloud-based personal document apps monetize user metadata or present single-point-of-failure security risks.
LifeOS brings clarity, discipline, and total privacy to personal life administration:
- Local-First Personal Vault: 100% offline, zero tracking, zero telemetries. Sensitive personal data stays strictly on your machine in
~/.lifeos/vault.json. - Unified Priority Timeline: Real-time urgency calculation (
overdue,urgent ≤7d,soon ≤30d,upcoming ≤90d,future). - Statutory Warranty Guardian: Automatically calculates the statutory 24-month consumer warranty duration and associates proof-of-purchase references and serial numbers.
- Administrative Procedure Checklist: Step-by-step progress bars and due dates for complex bureaucratic paperwork (e.g. passport issuance, residency transfer).
- Standard RFC 5545 iCalendar Feeds: Exports clean
.icscalendar files with multi-stage reminder alarms (-P7D,-P0D) compatible with Apple Calendar, Google Calendar, and Outlook. - Zero Runtime Dependencies & < 1,500 LOC Core: Written in modern pure TypeScript, running natively on Node.js without third-party runtime package overhead.
🚀 Quick start
Launch instantly with npx or clone the repository:
# 1. View the personal dashboard with the pre-loaded synthetic pilot scenario
npx lifeos demo
# 2. Run the Tripartite Integrity Audit (Observed Facts vs Estimates vs Decisions)
npx lifeos audit
# 3. Fast search across documents, warranties, and paperwork
npx lifeos search passaporto
# 4. Add an identity document
npx lifeos doc add --title="Passaporto Italiano" --category=identity --expiry=2034-05-10 --issuer="Questura di Torino"
# 5. Add an appliance or hardware warranty (calculates 24-month statutory warranty automatically)
npx lifeos warranty add --item="MacBook Pro 14 M3" --purchase=2025-01-15 --months=24 --brand="Apple"
# 6. View active paperwork and tick off a completed step
npx lifeos task list
npx lifeos task done --id=proc_passaporto_rinnovo --step=step_bollettino
# 7. Export an iCalendar feed to sync with your phone / calendar
npx lifeos export --format=ics --out=lifeos-deadlines.ics
# 8. Export a printable Markdown dossier or interactive offline HTML report
npx lifeos export --format=md --out=Dossier.md
npx lifeos export --format=html --out=dashboard.html
# 9. Generate a daily notification digest or view vault analytics
npx lifeos digest --days=14 --format=md
npx lifeos stats
# 10. Instantiate a procedure from built-in bureaucratic templates
npx lifeos task templates
npx lifeos task init --template=passport-renewalnpm install -g lifeos
# or clone locally:
git clone https://github.com/MRJonam91/LifeOS.git
cd LifeOS
npm install
npm test
npm run build- Observed Verifiable Facts: Exact document IDs, issue/expiry dates, verified receipt numbers, and executed checklist timestamps.
- Calculated Estimates: Countdown days, urgency classifications, and standard warranty durations.
- Required Human Decisions: Passport appointments, notice of contract termination, and fee payments.
LifeOS does not replace your bank or password manager: it is the master administrative binder that ensures you never miss a deadline or lose a warranty.
Detailed architectural specifications: docs/ARCHITECTURE.md.
LifeOS is dual-licensed:
- Open-Source (AGPL-3.0-only): Free to use, inspect, modify, and self-host under copyleft terms. Derivative SaaS or network services must disclose their modified source code.
- Commercial License: For enterprise employee benefits portals, insurance companies, or commercial software wishing to embed LifeOS without AGPL-3.0 copyleft terms.
See LICENSING.md and COMMERCIAL-LICENSE.md for complete details.
LifeOS is free and open-source software built and maintained by Manoj Rollo (MRJonam91). If LifeOS helps protect your personal rights, saves you money on warranties, or prevents missed administrative deadlines, please consider sponsoring: