$ show antoniorodr/memo
Memo is a Python CLI tool for managing Apple Notes and Apple Reminders directly from the terminal. It uses Click for command-line interface and AppleScript (via osascript) to interact with macOS's Notes and Reminders applications. The application provides commands to list, view, add, edit, delete, move, search, and export notes, as well as manage reminders (list, complete, add, delete, edit). Notes are fetched as HTML from Apple Notes, converted to Markdown for display and editing, and images are handled via a placeholder mechanism to preserve inline images through edit cycles. The architecture is a standard CLI application with helper modules for each operation, caching for notes, and validation for flag combinations. It is well-tested with pytest, uses modern Python 3.13, and has a professional CI/CD pipeline and documentation site.
The LLM identified 2 files worth highlighting for reuse:
Implements a simple TTL-based file cache for storing serialized data (note_map and notes_list). Provides save_cache, load_cache, and clear_cache functions. The cache file is stored in ~/.cache/memo/notes_cache.json and includes a timestamp for TTL checking (default 5 minutes). This is a reusable pattern for any Python application needing a lightweight, file-based cache with configurable expiration.
Provides functions to extract base64-encoded inline images from HTML (as produced by Apple Notes) and replace them with placeholder markers like [MEMO_IMG_N] before converting to Markdown. Also includes restore_images to put placeholders back into HTML after editing. This is a reusable pattern for handling inline images in Markdown conversion workflows, especially when editing content that contains images in base64 format.