Apple Notes Semantic Organizer v2.0

A powerful AI-driven tool to organize and consolidate Apple Notes using the PARA method and Gemini Semantic Embeddings.

Features

• PARA Classification: Automatically routes notes to Projects, Areas, Resources, or Archive.
• Semantic Consolidation: Identifies fragmented notes on the same topic and merges them into high-quality "Master Notes".
• Local Persistence: SQLite-based embedding cache prevents redundant API calls and ensures sub-second similarity lookups.
• High-Speed Sync: Uses note modification dates for extremely fast library-wide synchronization.
• Distillation: Gemini 1.5 Flash distills multiple source fragments into a clean, well-organized summary.
• Smart Routing: Autonomous PARA folder selection based on consolidated content.

Commands

1. Library Sync

Populate the local semantic index with embeddings from your entire Apple Notes library.

python3 sort_notes.py --sync

2. Semantic Analysis

Identify potential merge clusters without making any changes.

python3 sort_notes.py --analyze --threshold 0.90

3. Semantic Consolidation

Execute the auto-pilot merger. This will create Master Notes and move source fragments to the Trash.

python3 sort_notes.py --consolidate --threshold 0.92

Add --dry-run to see proposed changes without executing them.

4. Backlog Processing (Original Mode)

Process individual notes from a specific backlog folder (e.g., "Mixed notes").

python3 sort_notes.py

Configuration

Update the API_KEY and BACKLOG_FOLDER constants in sort_notes.py.

Requirements

• macOS (with Apple Notes app)
• Python 3.10+
• google-genai library
• Gemini API Key with access to text-embedding-004 and gemini-1.5-flash.