Metadata-Version: 2.4
Name: simple-memo
Version: 0.2.0
Summary: A simple, MIT-licensed CLI for Apple Notes & Reminders on macOS
Project-URL: Homepage, https://github.com/inkolin/simple-memo
Project-URL: Repository, https://github.com/inkolin/simple-memo
Project-URL: Issues, https://github.com/inkolin/simple-memo/issues
Author: Nenad Nikolin
License-Expression: MIT
License-File: LICENSE
Keywords: apple-notes,cli,macos,productivity,reminders
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Requires-Dist: click>=8.0
Requires-Dist: html2text>=2024.2.26
Requires-Dist: mistune>=3.0
Description-Content-Type: text/markdown

# simple-memo

A simple, MIT-licensed CLI for Apple Notes & Reminders on macOS.

Use it from the terminal, scripts, or AI agents — no restrictions, no confirmation dialogs.

## Features

- Full Apple Notes management (create, read, edit, append, move, delete, search, export)
- Full Apple Reminders management (add, complete, edit, delete)
- No confirmation dialogs — all operations resolve internally via Apple's note/reminder IDs
- AI-agent friendly — every command works non-interactively with `-y` flag
- Markdown in, Markdown out — notes are stored as HTML but you work in Markdown
- Interactive fuzzy search with [fzf](https://github.com/junegunn/fzf) support
- Pipe-friendly — create notes from stdin

## Install

```bash
pip install simple-memo
# or
pipx install simple-memo
```

## Notes

```bash
simple-memo list                          # List all notes
simple-memo list -f Work                  # List notes in a folder
simple-memo folders                       # List all folders
simple-memo read "Meeting Notes"          # Read a note (Markdown)
simple-memo create "Title" "Body text"    # Create a note
simple-memo create -i                     # Create in $EDITOR
simple-memo create "Title" -f Work        # Create in specific folder
echo "piped" | simple-memo create "Title" # Create from stdin
simple-memo edit "Meeting Notes"          # Edit in $EDITOR
simple-memo append "Title" "More text"    # Append to a note
simple-memo move "Title" "Archive"        # Move to folder (creates if needed)
simple-memo search "keyword"              # Search by content/title
simple-memo search --fzf                  # Interactive fuzzy search (requires fzf)
simple-memo delete -y "Old Note"          # Delete a note
simple-memo count                         # Count total notes
simple-memo export                        # Export all to ~/Desktop/simple-memo-export/
simple-memo export -o ./backup            # Export to custom directory
simple-memo export --html                 # Export as HTML instead of Markdown
simple-memo mkfolder "Projects"           # Create a folder
simple-memo rmfolder -y "Old Stuff"       # Delete a folder
```

## Reminders

```bash
simple-memo rem list                      # List non-completed reminders
simple-memo rem list -a                   # List all (including completed)
simple-memo rem add "Buy milk"            # Create reminder (no due date)
simple-memo rem add "Meeting" -d 2025-03-01 -t 14:00  # With due date
simple-memo rem done "Buy milk"           # Mark as completed
simple-memo rem edit "Meeting" --new-title "Team sync"  # Rename
simple-memo rem edit "Meeting" --new-date "2025-03-05 10:00"  # Reschedule
simple-memo rem delete -y "Old reminder"  # Delete
```

## No Confirmation Dialogs

Other Apple Notes CLI tools get stuck on macOS confirmation dialogs when deleting notes or reminders. `simple-memo` resolves every operation via Apple's internal note/reminder IDs, which bypasses all system dialogs completely. Delete, move, edit — everything works instantly without any popups or timeouts.

## Why?

Existing Apple Notes CLI tools use restrictive licenses that prohibit AI usage. `simple-memo` is MIT-licensed — use it however you want, including with AI agents, commercial products, and automation scripts.

## Requirements

- macOS (uses AppleScript to talk to Apple Notes & Reminders)
- Python 3.9+
- Optional: [fzf](https://github.com/junegunn/fzf) for interactive search

## License

MIT — see [LICENSE](LICENSE)
