my-project-public

repository

loading code, commits, and activity

repositories

loading repo index

#1	---
#2	name: apple-reminders
#3	description: Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
#4	homepage: https://github.com/steipete/remindctl
#5	metadata: {"clawdbot":{"emoji":"⏰","os":["darwin"],"requires":{"bins":["remindctl"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/remindctl","bins":["remindctl"],"label":"Install remindctl via Homebrew"}]}}
#6	---
#7
#8	# Apple Reminders CLI (remindctl)
#9
#10	Use `remindctl` to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.
#11
#12	Setup
#13	- Install (Homebrew): `brew install steipete/tap/remindctl`
#14	- From source: `pnpm install && pnpm build` (binary at `./bin/remindctl`)
#15	- macOS-only; grant Reminders permission when prompted.
#16
#17	Permissions
#18	- Check status: `remindctl status`
#19	- Request access: `remindctl authorize`
#20
#21	View Reminders
#22	- Default (today): `remindctl`
#23	- Today: `remindctl today`
#24	- Tomorrow: `remindctl tomorrow`
#25	- Week: `remindctl week`
#26	- Overdue: `remindctl overdue`
#27	- Upcoming: `remindctl upcoming`
#28	- Completed: `remindctl completed`
#29	- All: `remindctl all`
#30	- Specific date: `remindctl 2026-01-04`
#31
#32	Manage Lists
#33	- List all lists: `remindctl list`
#34	- Show list: `remindctl list Work`
#35	- Create list: `remindctl list Projects --create`
#36	- Rename list: `remindctl list Work --rename Office`
#37	- Delete list: `remindctl list Work --delete`
#38
#39	Create Reminders
#40	- Quick add: `remindctl add "Buy milk"`
#41	- With list + due: `remindctl add --title "Call mom" --list Personal --due tomorrow`
#42
#43	Edit Reminders
#44	- Edit title/due: `remindctl edit 1 --title "New title" --due 2026-01-04`
#45
#46	Complete Reminders
#47	- Complete by id: `remindctl complete 1 2 3`
#48
#49	Delete Reminders
#50	- Delete by id: `remindctl delete 4A83 --force`
#51
#52	Output Formats
#53	- JSON (scripting): `remindctl today --json`
#54	- Plain TSV: `remindctl today --plain`
#55	- Counts only: `remindctl today --quiet`
#56
#57	Date Formats
#58	Accepted by `--due` and date filters:
#59	- `today`, `tomorrow`, `yesterday`
#60	- `YYYY-MM-DD`
#61	- `YYYY-MM-DD HH:mm`
#62	- ISO 8601 (`2026-01-04T12:34:56Z`)
#63
#64	Notes
#65	- macOS-only.
#66	- If access is denied, enable Terminal/remindctl in System Settings → Privacy & Security → Reminders.
#67	- If running over SSH, grant access on the Mac that runs the command.
#68

z6Mkq5mY3JWtxoxUobWcfNHm7AkRubgSWEZTkBVqZXJviFZ5/my-project-public