{"id":45128091,"url":"https://github.com/aloth/mindful-coffee","last_synced_at":"2026-02-19T23:31:18.097Z","repository":{"id":280668994,"uuid":"942773013","full_name":"aloth/mindful-coffee","owner":"aloth","description":"Mindful Coffee ☕️ – Smart iOS caffeine log with cortisol rhythm modeling to optimize energy \u0026 sleep. Built with SwiftUI, SwiftData, HealthKit \u0026 on-device ML.","archived":false,"fork":false,"pushed_at":"2026-02-12T16:11:21.000Z","size":57549,"stargazers_count":4,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-13T00:29:52.548Z","etag":null,"topics":["ai","biohacking","chronobiology","circadian-rhythm","coffee","cortisol","data-visualization","healthkit","ios","longevity","machine-learning","personalization","predictive-modeling","privacy-focused","quantified-self","sleep-prediction","swift","swiftdata","swiftui","wellness"],"latest_commit_sha":null,"homepage":"http://mindfulcoffee.alexloth.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aloth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-04T16:45:21.000Z","updated_at":"2026-02-12T16:17:47.000Z","dependencies_parsed_at":"2025-07-07T14:38:02.229Z","dependency_job_id":"369b1204-70b9-422a-87dc-ca4d86399824","html_url":"https://github.com/aloth/mindful-coffee","commit_stats":null,"previous_names":["aloth/mindful-coffee"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aloth/mindful-coffee","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloth%2Fmindful-coffee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloth%2Fmindful-coffee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloth%2Fmindful-coffee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloth%2Fmindful-coffee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aloth","download_url":"https://codeload.github.com/aloth/mindful-coffee/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aloth%2Fmindful-coffee/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29636492,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T22:32:43.237Z","status":"ssl_error","status_checked_at":"2026-02-19T22:32:38.330Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","biohacking","chronobiology","circadian-rhythm","coffee","cortisol","data-visualization","healthkit","ios","longevity","machine-learning","personalization","predictive-modeling","privacy-focused","quantified-self","sleep-prediction","swift","swiftdata","swiftui","wellness"],"created_at":"2026-02-19T23:31:17.416Z","updated_at":"2026-02-19T23:31:18.091Z","avatar_url":"https://github.com/aloth.png","language":"HTML","readme":"# Mindful Coffee - Caffeine Tracker App for iPhone with Sleep Prediction \u0026 Cortisol Rhythm\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/images/mindful-coffee-caffeine-tracker-sleep-optimization-hero.png\" alt=\"Mindful Coffee — smart caffeine tracking with sleep prediction and cortisol rhythm optimization\" width=\"700\"\u003e\n\u003c/p\u003e\n\n**The smartest way to track caffeine, predict your sleep, and optimize your energy throughout the day.**\n\nStop guessing when you'll be ready for bed. Mindful Coffee is a beautifully designed iOS app that tracks your coffee, tea, and energy drink consumption while showing you exactly when caffeine will clear your system for quality sleep. Understand your body's natural cortisol rhythm and time your caffeine perfectly for peak performance.\n\nBuilt with Apple's stunning **Liquid Glass** design language, Mindful Coffee feels right at home on your iPhone with its modern translucent interface and buttery-smooth animations.\n\n## Why Mindful Coffee?\n\nMost caffeine trackers just count milligrams. Mindful Coffee goes deeper - it models your personal metabolism, visualizes your cortisol awakening response, and predicts your optimal sleep time based on real science. Whether you're a coffee enthusiast optimizing your morning routine or someone trying to improve sleep quality, this app gives you the insights you need.\n\n## Key Features\n\n**Track Smarter, Sleep Better**\n\n- **Daily Logging Streaks** - Stay motivated with visual streak counters that celebrate your consistency\n- **Caffeine-Free Day Tracking** - Log intentional caffeine-free days to maintain your streak while taking mindful breaks\n- **Sleep Insights Card** - See last night's sleep duration and caffeine impact at a glance\n- **Grouped History View** - Browse your consumption history with the current month expanded and past months neatly summarized\n\n**Intelligent Caffeine Tracking**\n\n- **One-Tap Logging** - Record coffee, tea, energy drinks, and custom beverages instantly\n- **Smart Sorting** - Sort your drink list by \"Last Used\" or \"Most Used\" for faster logging\n- **Real-Time Sleep Prediction** - Know exactly when you'll be ready for quality sleep based on your intake\n- **What-If Simulator** - Preview how another drink would affect your sleep time before you consume it\n\n**Personalized to Your Body**\n\n- **Personal Metabolism Quiz** - Answer guided questions to calibrate sensitivity, half-life, and sleep thresholds\n- **AI Insights (Pro)** - Get personalized caffeine commentary powered by Apple Intelligence. Context-aware messages adapt to your energy levels, time of day, and sleep patterns - all processed entirely on-device. The AI research foundation is based on the [JudgeGPT project](https://github.com/aloth/JudgeGPT). *(Requires iPhone 15 Pro or iPhone 16 series, iPad Air/Pro with M1+, iPad mini with A17 Pro, or Mac with Apple Silicon, running iOS 18.1+, iPadOS 18.1+, or macOS 15.1+)*\n- **Cortisol Rhythm Modeling** - Visualize your body's natural energy curve and optimize caffeine timing\n- **Sleep Correlation Analysis** - Discover how caffeine levels affect your actual sleep duration using Apple Health data\n\n**Seamless Apple Integration**\n\n- **HealthKit Sync** - Automatically log caffeine to Apple Health and import sleep data for deeper insights\n- **Import from Other Apps** - Bring in caffeine data from third-party apps via HealthKit\n- **CSV Export** - Full data ownership with complete history export\n\n## Screenshots\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Real-Time Caffeine \u0026 Cortisol Tracking\nVisualize your caffeine decay curve alongside your body's natural cortisol rhythm. The intelligent assistant provides personalized recommendations for optimal caffeine timing.\n\n\u003cimg src=\"screenshots/mindful-coffee-caffeine-tracker-cortisol-rhythm-chart.png\" alt=\"Mindful Coffee app showing real-time caffeine decay chart with cortisol rhythm curve and sleep prediction\" width=\"400\"/\u003e\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Data-Driven Sleep Insights\nAnalyze how your caffeine intake affects sleep quality across different consumption levels. Track correlations between daily caffeine and sleep duration with personalized thresholds.\n\n\u003cimg src=\"screenshots/caffeine-sleep-correlation-analysis-ios-app.png\" alt=\"Caffeine and sleep correlation analysis showing average sleep duration across different caffeine intake levels\" width=\"400\"/\u003e\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Quick Logging with Smart Predictions\nLog your coffee, tea, or energy drinks instantly. See real-time predictions of how each beverage will affect your sleep readiness before you drink it.\n\n\u003cimg src=\"screenshots/coffee-tea-caffeine-logging-interface-smart-predictions.png\" alt=\"Quick caffeine logging interface with beverage icons, caffeine amounts, and smart sleep impact predictions\" width=\"400\"/\u003e\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Personal Metabolism Calibration\nCustomize the app to match your unique caffeine metabolism. Adjust sensitivity, half-life, sleep thresholds, and cortisol parameters for precise tracking tailored to your body.\n\n\u003cimg src=\"screenshots/cortisol-rhythm-settings-personal-metabolism-assistant.png\" alt=\"Personal metabolism assistant and cortisol rhythm customization settings for precise caffeine tracking\" width=\"400\"/\u003e\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## Download Now\n\nTake control of your caffeine habits and sleep better tonight:\n\n[![Download on the App Store](https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg)](https://apps.apple.com/us/app/mindful-coffee-tracks-caffeine/id6742878005?platform=iphone)\n\n[**Visit the Official Website**](http://mindfulcoffee.alexloth.com) - Learn more about features, the science behind it, and latest updates\n\n---\n\n## The Science Behind Mindful Coffee\n\nThe cortisol modeling feature is grounded in established research from chronobiology and longevity science. For a detailed look at the underlying science, see the [**Research Background**](./RESEARCH_BACKGROUND.md).\n\n**Interested in research collaboration?** If you're a researcher or student working in chronobiology, sleep science, or related fields, reach out at `support+mindfulcoffee@alexloth.com`.\n\n### Citing the App\n\n```bibtex\n@software{Loth2025MindfulCoffeeApp,\n  author       = {Loth, Alexander},\n  title        = {Mindful Coffee: Caffeine Log \u0026 Cortisol Rhythm},\n  year         = {2025},\n  version      = {5.3},\n  publisher    = {Alexander Loth},\n  url          = {https://apps.apple.com/us/app/mindful-coffee-tracks-caffeine/id6742878005}\n}\n```\n\n## Privacy First\n\nYour data stays on your device. Mindful Coffee stores all consumption data locally using SwiftData. HealthKit access requires your explicit permission following Apple guidelines. **All calculations, analysis, AI insights, and modeling run entirely on-device** - nothing is ever sent to a server.\n\nRead the full [Privacy Policy](https://github.com/aloth/mindful-coffee/blob/main/privacy_policy.md).\n\n## FAQ \u0026 Support\n\nQuestions about caffeine science, app features, or troubleshooting? Check out the comprehensive FAQ:\n\n[**Frequently Asked Questions**](./FAQ.md)\n\nAlso available in: [Deutsch](./FAQ_de.md) | [Español](./FAQ_es.md) | [Français](./FAQ_fr.md) | [日本語](./FAQ_ja.md) | [简体中文](./FAQ_zh-Hans.md)\n\n## Available Languages\n\nMindful Coffee is fully localized in English, German, Spanish, French, Japanese, and Simplified Chinese.\n\n**README in other languages:**\n[Deutsch](./README_de.md) | [Español](./README_es.md) | [Français](./README_fr.md) | [日本語](./README_ja.md) | [简体中文](./README_zh-Hans.md)\n\n---\n\n## Feedback \u0026 Support\n\nHelp make Mindful Coffee even better:\n\n- **Report a Bug**: [Open an Issue](https://github.com/aloth/mindful-coffee/issues/new?template=bug_report.md)\n- **Suggest a Feature**: [Open a Feature Request](https://github.com/aloth/mindful-coffee/issues/new?template=feature_request.md)\n\n---\n\n**Track smarter. Sleep better. Feel your best with Mindful Coffee.**\n\n[![Download on the App Store](https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg)](https://apps.apple.com/us/app/mindful-coffee-tracks-caffeine/id6742878005?platform=iphone)\n\n[Visit Website](http://mindfulcoffee.alexloth.com)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faloth%2Fmindful-coffee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faloth%2Fmindful-coffee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faloth%2Fmindful-coffee/lists"}