Dayflow README

The project's README from github.com/JerryZLiu/Dayflow. As one markdown file: README.md.

Dayflow

A private, automatic work journal for Mac.

Dayflow understands the work you do on your Mac and turns it into a clear timeline of your day. Built from the ground up for privacy, it’s open source, local-first, and can run entirely with local AI.

JerryZLiu/Dayflow | Trendshift

Download Dayflow for Mac

Automatic Timeline

Dayflow turns raw screen activity into a chronological timeline of what you actually did, so you can reconstruct the day without timers or manual notes.

Dayflow automatic timeline view

Daily Standup

See a GitHub-style activity grid of your day, plus yesterday's highlights, today's priorities, and blockers, so you can walk into standup with the update already written.

Dayflow daily workflow and standup view

Weekly Review

See your week at a glance: when you were focused, where time went, which apps dominated, and what pulled you off track.

Dayflow weekly analytics view

Chat With Your Work Journal

Ask questions about your day/week/year and get answers grounded in your timeline instead of digging through notes, screenshots, or memory.

Dayflow chat feature answering questions about your workday

What Dayflow Does

Dayflow runs quietly on your Mac and builds a useful record of your day from your screen activity.

Feature How it works Why it's useful
Automatic timeline Dayflow captures lightweight screen chunks, analyzes them with your chosen AI provider, and turns the day into activity cards. You get an accurate work journal without starting timers or writing notes.
Context-aware summaries It looks at what you were actually doing on screen, not just which app was active. Cursor, Chrome, YouTube, or Slack become meaningful work context instead of vague app usage.
Daily standup Dayflow pulls yesterday's highlights, today's tasks, and blockers from your timeline. You can write updates in minutes and stop relying on memory.
Chat with your work journal Ask natural-language questions about your timeline and recent activity. You can recover details, explain where time went, and turn raw activity into useful answers.
Weekly review It aggregates your timeline into focus patterns, categories, app usage, and interaction graphs. You can see where the week actually went and spot the habits that helped or hurt.
Distraction tracking Dayflow identifies distracting sessions and shows them alongside focused work. You can catch drift early without manually labeling every break.
Timeline export Export your timeline as Markdown for any date range. Useful for status updates, client notes, personal reviews, or saving a searchable record.
Local-first storage Recordings, timeline data, and the app database stay on your Mac by default. You stay in control of sensitive screen history and can delete it whenever you want.
AI provider choice Use local models, Gemini, ChatGPT, or Claude depending on your privacy and quality needs. You can trade off privacy, cost, speed, and summary quality instead of being locked into one backend.
Automatic cleanup Configure storage limits and let Dayflow purge old recordings automatically. You get the value of a work journal without filling your disk forever.

Why People Use It

Most time trackers tell you which app was open. Dayflow tries to understand what you were doing.

Cursor for two hours could mean shipping a feature, debugging auth, reviewing a PR, or getting lost in setup. Dayflow gives you the context, not just the window title.

Privacy

Dayflow is local-first and open source.

Your recordings, timeline, and database live on your Mac at:

~/Library/Application Support/Dayflow/

You choose how AI analysis runs:

If you choose a cloud provider, activity data needed for analysis is sent to that provider. If you choose local models, analysis stays on your machine.

Install

Download

Download the latest Dayflow.dmg from GitHub Releases:

Download Dayflow for Mac

Open the DMG, drag Dayflow into Applications, then grant macOS Screen & System Audio Recording permission when prompted.

Homebrew

brew install --cask dayflow

Requirements

Build From Source

git clone https://github.com/JerryZLiu/Dayflow.git
cd Dayflow
open Dayflow/Dayflow.xcodeproj

Select the Dayflow scheme in Xcode and run it.

Contributing

Issues and pull requests are welcome. If you are planning a larger change, open an issue first so the scope is clear.

License

Dayflow is licensed under the MIT License.

dayflow.so · Pricing · Privacy · Guides

Dayflow (JerryZLiu/Dayflow)

Searching Database…

7.3K ·GitHub
这是什么?Dayflow 是一款 Mac 上的私密自动工作日志工具,它会监视你的屏幕活动,并将其转换成清晰的时间线,按时间顺序记录你一天中实际做过的事情,无需手动计时或记笔记。
它会录制我屏幕的完整视频,还是只定期截取活动快照?Dayflow 会按间隔捕捉轻量级的屏幕片段,并发送给你选择的 AI 提供商进行分析,由其生成活动卡片,而不是录制原始视频。
我可以使用哪些 AI 提供商,需要 API 密钥吗?你可以通过 Ollama 或 LM Studio 完全在本地运行分析,使用自己的 API 密钥搭配 Gemini,或通过它们的本地 CLI 工具走 ChatGPT/Claude 通道;如果只用本地模型,则无需任何账号。
如果选择云端 AI 提供商而不是本地模型,有什么取舍?选择 Gemini、ChatGPT 或 Claude 等云端提供商会把分析所需的活动数据发送出你的电脑,而本地模型能把所有数据留在设备上,代价是摘要质量可能较低。
它也能在 Windows 或 Linux 上运行吗?不能,Dayflow 仅支持 Mac,需要 macOS 14 或更高版本,以及「屏幕和系统音频录制」权限。
我的屏幕活动数据会发送到哪里?默认情况下,你的录制内容、时间线和数据库只保存在你的 Mac 上。如果你选择云端 AI 提供商,分析所需的活动数据就会发送给该提供商。
Dayflow 和普通的时间追踪工具有什么不同?大多数时间追踪工具只记录当前聚焦的应用,而 Dayflow 会分析屏幕上实际显示的内容,因此在 Cursor 中的两小时可以被识别为是在开发新功能还是在调试,而不只是「Cursor:2h」。
我能和自己的时间线对话吗?可以,你可以用自然语言询问关于你一天、一周或一年的问题,并获得基于你已记录活动的回答,而不必依赖记忆或截图。
我能导出时间线用于工作汇报吗?可以,Dayflow 能将任意日期范围的时间线导出为 Markdown,方便用于进度报告、客户记录或个人存档。
它能帮我准备每日站会吗?可以,它会直接从你的时间线中提取昨天的重点、今天的优先事项和遇到的阻碍,让你几分钟内就能写好站会汇报。
Creator
JerryZLiu
Size
162 MB
Stars
7.3K
Age
1y
Commits · 90 Days