Skip to content
This repository was archived by the owner on Jul 4, 2026. It is now read-only.

terry-li-hm/moneo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

moneo

CLI for Due — the iOS/macOS reminder app. List, add, edit, delete, and search reminders from the terminal.

Built for AI agent workflows where Due is the time-sensitive reminder layer.

Install

# Python (recommended — active version)
cp moneo.py ~/.local/bin/moneo
chmod +x ~/.local/bin/moneo

Requires Python 3.11+ and uv (used as the script runner).

Usage

moneo ls                          # List all reminders
moneo add "Buy milk" --due tomorrow   # Add a reminder
moneo add "Meds" --due "9:05" --every daily  # Recurring
moneo edit 3 --title "New title"  # Edit by index
moneo rm "Buy milk"               # Delete by title
moneo log                         # Completion history
moneo search "dentist"            # Open Due and search
moneo snapshot                    # Git-commit DB snapshot

How it works

moneo reads and writes Due's internal SQLite database directly:

~/Library/Containers/com.phocusllp.duemac/Data/Library/Application Support/Due App/Due.duedb

Database caveat: This tool accesses Due's private, undocumented database schema. It works as of Due 3.x on macOS, but:

  • Due updates may change the schema without notice, breaking reads or writes.
  • Writing to the DB while Due is running may cause sync conflicts — moneo mitigates this by triggering Due's CloudKit sync via AppleScript after writes.
  • Deletions are Mac-local and may not sync to iPhone. The rm command warns about this.
  • Back up your Due database before first use. moneo snapshot commits a gzipped copy to git.

This is not an official Due integration. Use at your own risk.

License

MIT

About

CLI for Due — the iOS/macOS reminder app

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages