Erstellen Sie Listen, fügen Sie Erinnerungen hinzu, organisieren Sie diese in Sektionen und synchronisieren Sie alles über alle Ihre Apple-Geräte hinweg – direkt vom Terminal aus.

Warum remi?

Sektionen mit iCloud-Synchronisierung — das einzige CLI, das Apple-Erinnerungssektionen unterstützt. Erstellen Sie diese, weisen Sie Erinnerungen zu, verschieben Sie sie zwischen den Sektionen – alles wird synchronisiert.
Natürliche Sprache — --due "next tuesday", --repeat "every 2 weeks on monday,friday"
Fuzzy-Matching — geben Sie remi list shopping ein anstatt remi list "Groceries / Shopping List"
Agent-first — strukturierte JSON-Ausgabe, Claude Code-Plugin, skills.sh-Skill, OpenClaw-kompatibel
Schnell — kompilierte Swift-Helfer, kein Electron, keine GUI

Im Vergleich zu anderen Tools

	remi	remindctl	reminders-cli
Sektionen	Ja	Nein	Nein
Sektions-Sync (iCloud)	Ja	N/A	N/A
Wiederholung	Ja	Ja	Nein
Datumsangaben in natürlicher Sprache	Ja	Ja	Nein
JSON-Ausgabe	Ja	Ja	Nein
KI-Agenten-Integration	Ja	Teilweise	Nein

Installation

brew tap mattheworiordan/tap && brew install remi

Oder via npm:

npm install -g @mattheworiordan/remi
# or run without installing
npx @mattheworiordan/remi lists

Schnellstart

remi lists                                              # See all lists
remi list "Groceries"                                   # View a list (fuzzy: remi list groceries)
remi add "Groceries" "Buy milk" --section "Dairy"       # Add to a section
remi today                                              # What's due today?
remi complete "Groceries" "milk"                        # Fuzzy complete

Verwendung

Prüfen, was ansteht

remi today                    # Due today
remi overdue                  # Past due
remi upcoming --days 7        # Coming up
remi search "dentist"         # Search across all lists

Erinnerungen verwalten

remi add "Work" "Review PR" --due "next friday" --priority high
remi add "Work" "Standup" --due tomorrow --repeat daily
remi complete "Work" "standup"
remi update "Work" "Review PR" --due "in 3 days"
remi delete "Work" "Review PR" --confirm

Datumsangaben: tomorrow, next tuesday, in 3 days oder YYYY-MM-DD Wiederholung: daily, weekly, monthly, every 2 weeks, every 3 months on monday,friday

Mit Sektionen organisieren

remi sections "Groceries"                                # List sections
remi create-section "Groceries" "Produce"                # Create a section
remi add "Groceries" "Bananas" --section "Produce"       # Add to a section
remi move "Groceries" "Bananas" --to-section "Dairy"     # Move between sections

Sektionen werden via CRDT-Vektorkuhren mit iCloud synchronisiert. Siehe wie es funktioniert.

JSON-Ausgabe

Jeder Befehl unterstützt --json für maschinenlesbare Ausgaben:

remi today --json
# {"success": true, "data": [...]}

KI-Agenten-Integration

remi ist für KI-Agenten konzipiert. Verwenden Sie es als MCP-Server, Claude Code-Plugin oder Skill:

MCP-Server

{
  "mcpServers": {
    "remi": {
      "command": "remi",
      "args": ["--mcp"]
    }
  }
}

16 Tools: remi_lists, remi_add, remi_complete, remi_move, remi_today, remi_search und mehr – alle mit Fuzzy-Matching und strukturierten Antworten.

Weitere Integrationen

# Claude Code plugin
claude plugin marketplace add mattheworiordan/remi

# skills.sh
npx skills add mattheworiordan/remi

# OpenClaw
clawhub install remi

Berechtigungen

Beim ersten Start wird macOS Sie bitten, den Zugriff auf Erinnerungen zu gewähren (klicken Sie auf Erlauben). Sektionsfunktionen benötigen außerdem Vollzugriff auf die Festplatte für Ihre Terminal-App.

remi authorize    # Guides you through both
remi doctor       # Shows what's granted

Anforderungen

macOS 13+ (Ventura oder neuer)
Node.js 18+
Xcode Command Line Tools (xcode-select --install)

Wie es funktioniert

remi verwendet drei Ebenen, da Apple Sektionen nie in ihrer öffentlichen API offengelegt hat:

Ebene	Was	Warum
EventKit	Erinnerungs-CRUD, Abfragen, Wiederholung	Stabile öffentliche API
ReminderKit	Sektions-CRUD	Privates Framework – der einzige Weg, Sektionen zu erstellen, die synchronisieren
SQLite + Token Maps	Sektionszugehörigkeit	Direkte Datenbankzugriffe mit CRDT-Vektorkuhren für iCloud-Sync

Die vollständige Reverse-Engineering-Geschichte erklärt, was wir über Apples undokumentierte Synchronisierungsarchitektur herausgefunden haben.

Mitwirken

git clone https://github.com/mattheworiordan/remi.git && cd remi
npm install && npm run build:swift && npm run build
npm test                        # Unit tests
npm run test:integration        # Integration tests (needs Reminders access)

Lizenz

MIT — Matthew O'Riordan

remi