Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Manage Apple iCloud Reminders via CloudKit API. Use for listing, adding, completing, deleting reminders, managing lists, and hierarchical subtasks. Works wit...
Manage Apple iCloud Reminders via CloudKit API. Use for listing, adding, completing, deleting reminders, managing lists, and hierarchical subtasks. Works wit...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Access and manage Apple iCloud Reminders via CloudKit API. Full CRUD with hierarchical subtask support. Pure Go โ no Python or pyicloud required. Authentication, 2FA, session management and CloudKit API calls are all implemented natively in Go.
brew tap tarekbecker/tap brew install icloud-reminders Upgrade to the latest version: brew upgrade icloud-reminders
One-line install for any platform: curl -sL https://github.com/tarekbecker/icloud-reminders-cli/releases/latest/download/install.sh | bash
Download manually for your platform from GitHub Releases.
Requires Go 1.22+: bash scripts/build.sh sudo cp go/reminders /usr/local/bin/ Development: Use scripts/reminders.sh from the repo root โ it auto-builds the binary if missing and loads credentials from the credentials file automatically.
Authenticate (interactive โ required on first run): reminders auth Credentials are resolved in this order: ICLOUD_USERNAME / ICLOUD_PASSWORD environment variables ~/.config/icloud-reminders/credentials file (export KEY=value format) Interactive prompt (fallback) Session file (~/.config/icloud-reminders/session.json) is created automatically and reused. Run reminders auth again when the session expires.
# First-time setup / force re-auth reminders auth reminders auth --force # List all active reminders (hierarchical) reminders list # Filter by list name reminders list -l "๐ Einkauf" # Include completed reminders list --all # or: -a # Show only children of a parent reminder (by name or short ID) reminders list --parent "Supermarkt" reminders list --parent ABC123DE # Search by title reminders search "milk" # Search including completed reminders search "milk" --all # or: -a # Show all lists (with active counts and short IDs) reminders lists # Add reminder (-l is REQUIRED) reminders add "Buy milk" -l "Einkauf" # Add with due date and priority reminders add "Call mom" -l "Einkauf" --due 2026-02-25 --priority high # Add with notes reminders add "Buy milk" -l "Einkauf" --notes "Get the organic 2% stuff" # Add as subtask (-l is REQUIRED even for subtasks) reminders add "Butter" -l "๐ Einkauf" --parent ABC123DE # Add multiple at once (batch; -l is REQUIRED) reminders add-batch "Butter" "Kรคse" "Milch" -l "Einkauf" # Add multiple as subtasks reminders add-batch "Butter" "Kรคse" -l "Einkauf" --parent ABC123DE # Complete reminder reminders complete abc123 # Delete reminder reminders delete abc123 # Export as JSON reminders json # Force full resync reminders sync # Export session cookies (share without password) reminders export-session session.tar.gz # Import session from export reminders import-session session.tar.gz # Verbose output (any command) reminders list -v
The binary handles sessions automatically: On each run: tries accountLogin with saved cookies to get a fresh CloudKit URL On failure / first run: triggers full interactive signin + 2FA Trust token: saved after 2FA so subsequent logins don't require a code Session file: ~/.config/icloud-reminders/session.json
โ Reminders: 101 (101 active) ๐ Shopping (12) โข Supermarket (ABC123DE) โข Butter (FGH456IJ) โข Cheese (KLM789NO) โข Drugstore (PQR012ST) โข Baking paper (UVW345XY) IDs (8-char) in parentheses โ use for complete, delete, --parent.
Cache: ~/.config/icloud-reminders/ck_cache.json (same JSON format as Python version โ shared/compatible) Delta sync: Fast incremental updates (default) Full sync: reminders sync โ can take ~2 min for large accounts
scripts/ โโโ reminders.sh # Dev wrapper (auto-builds + loads creds) โโโ build.sh # Build script โโโ install.sh # Install script (used by curl | bash one-liner) โโโ reminders # Compiled Go binary (generated) go/ โโโ main.go # Entry point โโโ auth/auth.go # Native iCloud auth (signin, 2FA, trust, accountLogin) โโโ cloudkit/client.go # CloudKit HTTP API client โโโ sync/sync.go # Delta sync engine โโโ writer/writer.go # Write ops (add/complete/delete) โโโ cache/cache.go # Local JSON cache โโโ models/models.go # Data types โโโ utils/utils.go # CRDT title encoding, timestamps โโโ cmd/ # Cobra CLI commands โโโ root.go # Root command; global --verbose / -v flag โโโ auth.go # reminders auth [--force] โโโ list.go # reminders list [-l] [--parent] [--all/-a] โโโ lists.go # reminders lists โโโ search.go # reminders search [--all/-a] โโโ add.go # reminders add / add-batch (both require -l) โโโ complete.go # reminders complete <id> โโโ delete.go # reminders delete <id> โโโ json_cmd.go # reminders json โโโ sync.go # reminders sync โโโ export_session.go # reminders export-session โโโ import_session.go # reminders import-session
IssueSolution"not authenticated"Run reminders auth"invalid Apple ID or password"Check credentials file"2FA failed"Re-run auth, enter a fresh code"Missing change tag"Run reminders sync"List not found"Check name with reminders listsBinary not foundRun bash scripts/build.sh or check your PATH
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.