iCloud Reminders

iCloud Reminders

访问 and manage 应用le iCloud Reminders via CloudKit API. Full CRUD with hierarchical subtask support.

Pure Go — no Python or pyicloud required. Authentication, 2FA, 会话 management and CloudKit API calls are all implemented natively in Go.

安装ation Homebrew (Recommended) brew tap tarekbecker/tap brew 安装 icloud-reminders

升级 to the latest version:

brew 升级 icloud-reminders

设置up

认证 (interactive — required on first 运行):

reminders auth

凭证s are resolved in this order:

ICLOUD_USERNAME / ICLOUD_PASSWORD 环境 variables ~/.config/icloud-reminders/凭证s file (导出 KEY=value 格式化) Interactive prompt (fallback)

会话 file (~/.config/icloud-reminders/会话.json) is 创建d automatically and reused. 运行 reminders auth agAIn when the 会话 expires.

Commands # First-time 设置up / force re-auth reminders auth reminders auth --force

# 列出 all active reminders (hierarchical) reminders 列出

# 过滤器 by 列出 name reminders 列出 -l "🛒 Groceries"

# Include completed reminders 列出 --all # or: -a

# Show only children of a parent reminder (by name or short ID) reminders 列出 --parent "Supermarket" reminders 列出 --parent ABC123DE

# 搜索 by title reminders 搜索 "milk"

# 搜索 including completed reminders 搜索 "milk" --all # or: -a

# Show all 列出s (with active counts and short IDs) reminders 列出s

# 添加 reminder (-l is REQUIRED) reminders 添加 "Buy milk" -l "Groceries"

# 添加 with due date and priority reminders 添加 "Call mom" -l "Groceries" --due 2026-02-25 --priority high

# 添加 with notes reminders 添加 "Buy milk" -l "Groceries" --notes "获取 the organic 2% stuff"

# 添加 as subtask (-l is REQUIRED even for subtasks) reminders 添加 "Butter" -l "🛒 Groceries" --parent ABC123DE

# 添加 multiple at once (batch; -l is REQUIRED) reminders 添加-batch "Butter" "Cheese" "Milch" -l "Groceries"

# 添加 multiple as subtasks reminders 添加-batch "Butter" "Cheese" -l "Groceries" --parent ABC123DE

# Edit a reminder (更新 title, due date, notes, or priority) reminders edit abc123 --title "New title" reminders edit abc123 --due 2026-03-01 --priority high reminders edit abc123 --notes "更新d notes" reminders edit abc123 --priority none

# Complete reminder reminders complete abc123

# 删除 reminder reminders 删除 abc123

# 导出 as JSON reminders json

# Force full re同步 reminders 同步

# 导出 会话 cookies (分享 without password) reminders 导出-会话 会话.tar.gz

# 导入 会话 from 导出 reminders 导入-会话 会话.tar.gz

# Verbose 输出 (any command) reminders 列出 -v

Troubleshooting Issue Solution "not 认证d" 运行 reminders auth "invalid 应用le ID or password" 检查 凭证s file "2FA fAIled" Re-运行 auth, enter a fresh code "Missing change tag" 运行 reminders 同步 "列出 not found" 检查 name with reminders 列出s Binary not found 运行 bash scripts/build.sh or 检查 your PATH