HanlanOS Architecture

Cloudflare Access

Email auth gate

Zero Trust authentication
Email login (no password)
Free for 50 users

Cloudflare Pages

Static hosting

Serves HTML/CSS/JS
Git auto-deploy
Global CDN

Browser / PWA

User device

Safari Add to Dock
Chrome Create Shortcut
Offline capable

HanlanOS Apps

11 apps

Today, Life Coach, Health
Travel, Art, Tidbits, Ideas
YouTube, Eureka, Spanish, Mission Control

hanlan-sync.js

Browser bridge

HanlanSync.save()
HanlanSync.load()
Auto localStorage fallback

localStorage

Offline fallback

Immediate persistence
Works offline
todayAppState

Supabase

Cloud database

PostgreSQL
Real-time subscriptions
JWT authentication

Sync Daemon

Mac background

Node.js on your Mac
Runs every 10 min
reminders-sync/

launchd

macOS scheduler

Starts at boot
Triggers sync
Logs to sync.log

Apple Reminders

Native app

Native notifications
Siri integration
HanlanOS lists

iCloud

Apple sync

Syncs to all devices
iPhone notifications
iPad, Mac, Watch

iPhone

Mobile device

Push notifications
Siri reminders
Native experience

ai-providers.js

HanlanAI

HanlanAI.chat()
Auto provider selection
Unified API

Ollama

Local LLM

Privacy-first
llama3, qwen3
localhost:11434

Groq

Cloud LLM

Fast inference
Fallback provider
Requires API key

Qwen3 Vision

Image analysis

Screenshot analysis
OCR, UI inspection
Via Ollama

Claude Code

Development AI

Anthropic CLI
Code assistance
MCP plugins

claude-mem

Memory MCP

search()
timeline()
Persistent observations

CLAUDE.md

Instructions

Project rules
CORE-LOCK config
Auto-loaded

Kaizen

Self-improvement

Observations & patterns
Hypotheses tracking
/reflect

Chronos McTwisp

Time intelligence

Time-saving insights
Pain point detection
/sync

Atlas

Architecture review

Code health audit
Integration review
/audit-hanlanos

Slash Commands

Agent triggers

/audit-hanlanos → Atlas
/reflect → Kaizen
/sync-hanlanos → Full sync

Sync Commands

Plugin sync

/sync-hanlancore
/sync-framercore
/migrate-plugin