Dayflow Sync

Export your Dayflow timeline to markdown notes. Perfect for Obsidian, Logseq, or any markdown-based workflow.

Why Dayflow Sync?

Dayflow is a macOS app that automatically records your screen activity and generates AI-powered timeline summaries. While Dayflow excels at capturing your day, your data deserves to live in your notes where you can:

• Review and reflect on your daily activities
• Build a searchable archive of your work patterns
• Link activities to projects and tasks
• Track productivity trends over time

This tool bridges Dayflow with your note-taking workflow, giving you full ownership of your timeline data in plain text format.

Privacy

Your data stays on your machine.

• 100% local processing — zero network calls, no data uploads
• Read-only database access — cannot modify your Dayflow data
• No tracking — no analytics, telemetry, or phone-home features
• Safe to run while Dayflow is active

Installation

Pre-built Binary

mkdir -p ~/dayflow-sync
curl -L https://github.com/zeroliu/dayflow-sync/releases/latest/download/dayflow-sync-macos.tar.gz | tar -xz -C ~/dayflow-sync
node ~/dayflow-sync/dayflow-sync.js --days 7

From Source

git clone https://github.com/zeroliu/dayflow-sync.git
cd dayflow-sync
npm install
npm run dev

Usage

# Sync last 7 days (default)
node src/dayflow-sync.js

# Sync last 30 days
node src/dayflow-sync.js --days 30

# Save to Obsidian vault
node src/dayflow-sync.js --output ~/Documents/MyVault/dayflow

# Force overwrite existing notes
node src/dayflow-sync.js --days 7 --force

Environment Variables

# Set default output directory
export DAYFLOW_OUTPUT_DIR="$HOME/Documents/MyVault/dayflow"

CLI Reference

Option	Default	Description
-d, --days <n>	7	Days to sync (1-365)
-o, --output <path>	./dayflow-notes	Output directory
--db <path>	~/Library/.../chunks.sqlite	Custom database path
--includeDeleted <0|1>	0	Include deleted cards
-f, --force	false	Overwrite existing notes

Output Format

Files are named Dayflow_YYYY-MM-DD.md and contain:

• YAML frontmatter — metadata for search/filtering
• Daily summary — total time, category breakdown
• Journal sections — intentions, goals, reflections (if recorded)
• Timeline — activity cards with times, apps, summaries
• Distractions log — off-task activities
• App usage — time per application

See examples/sample-output.md for a complete example.

Day Boundary

Dayflow uses a 4 AM boundary — activities between midnight and 4 AM belong to the previous day's note.

Automation

Sync daily with launchd:

1. Copy examples/launchd.plist.template to ~/Library/LaunchAgents/com.dayflow.sync.plist
2. Edit the paths in the file (node path, script path, output directory)
3. Load it:

launchctl load ~/Library/LaunchAgents/com.dayflow.sync.plist
launchctl list | grep dayflow  # verify

Commands:

• launchctl start com.dayflow.sync — run now
• launchctl unload ...plist — stop
• tail /tmp/dayflow-sync.log — view logs

Troubleshooting

Database not found

ls ~/Library/Application\ Support/Dayflow/chunks.sqlite

Ensure Dayflow is installed and has recorded some activity.

Permission denied

mkdir -p ~/Documents/MyVault/dayflow  # create output dir

Native module build fails

xcode-select --install
npm rebuild better-sqlite3

Node version

node --version  # must be >= 18

Automation not running

which node  # use this full path in plist
launchctl list | grep dayflow  # check if loaded
tail /tmp/dayflow-sync.error.log  # check errors

Contributing

1. Fork the repo
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Open an issue for bugs or feature requests.

Requirements

• macOS (Dayflow is macOS-only)
• Node.js 18+
• Dayflow installed

License

MIT — see LICENSE