v1.0.0 - Initial Release

notesctl v1.0.0

CLI tool to safely export Apple iCloud Notes to Markdown files.

Features

• Safe database access: Copy-first approach with read-only SQLite mode
• SELECT-only queries: All queries validated for safety
• Export to Markdown: YAML frontmatter with title, dates, folder
• Formatting support: Bold, italic, strikethrough, links
• Lists: Bullet, numbered, checklists, blockquotes
• Attachments: Image and file export
• Folder organization: Notes grouped by folder
• Dry-run mode: Preview without writing files

Commands

notesctl export -o ~/notes-backup     # Export all notes
notesctl export --dry-run             # Preview without writing
notesctl list-notes                   # List notes
notesctl list-folders                 # List folders  
notesctl stats                        # Show statistics

Installation

# With uv (recommended)
uv pip install notesctl

# With pip
pip install notesctl

Requirements

• macOS with Apple Notes
• Python 3.11+