reminders

A command-line connection to Apple Reminders for adding, listing, searching, updating, completing, and deleting reminders. It uses EventKit, Apple’s system framework for accessing reminders.

In plain words
What is it for?
Use it to create reminders with due dates, priorities, notes, alerts, repeats, or URLs, then search and inspect existing reminders.
Why use it?
It lets an agent manage reminders in a structured, scriptable way and verify changes using JSON output.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/sublimecoder/aios/reminders
Any agent
npx skills add sublimecoder/aios --skill reminders
Clone the repo
git clone --depth 1 https://github.com/sublimecoder/aios

Made for: Claude Code, Codex.

Per session 22 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 708 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00022 $0.00708
Opus 5 $0.00011 $0.00354
Sonnet 5 $0.00004 $0.00142
Haiku 4.5 $0.00002 $0.00071

Measured yesterday against content hash 99274f991fc7, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

reminders scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to reminders — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/reminders/SKILL.md · 102 lines

How it starts

The opening of the file, as written. The whole thing — 102 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Reminders

Use this for Apple Reminders tasks. Prefer rem over Things/AppleScript when the user wants an AI-friendly personal todo backend on macOS.

Tool

  • CLI: rem
  • Repo: https://github.com/BRO3886/rem
  • Install:
GOBIN=/opt/homebrew/bin go install github.com/BRO3886/rem/cmd/rem@latest

rem uses EventKit for normal reads/writes. It may need Reminders permission for the calling app in System Settings > Privacy & Security.

Start

Check access:

rem lists -o json
rem today -o json

Use JSON for anything scripted or verified:

rem list --incomplete -o json
rem search "flight" -o json
rem show <id> -o json

Add Tasks

Default: add directly, then verify by search/show.

rem add "Book LHR-SFO nonstop business flight" --due "tomorrow 9am" --priority high --notes "Nonstop only." -o json
rem search "LHR-SFO" -o json

Useful flags:

  • --list "Name": target list
  • --due "tomorrow 9am": due date/time; natural language is supported
  • --priority high|medium|low|none
  • --notes "text"
  • --url https://...
  • --silent: due date without notification
  • --remind-me 15m: alarm before due time
  • --repeat daily|weekly|monthly|yearly

Update / Complete / Delete

Find the UUID first, then mutate by id or unique short id:

rem search "flight" -o json
rem update <id> --name "New title" --due "friday 2pm" --notes "..." -o json
rem complete <id> -o json
rem delete <id> --force

Always read back after writes; do not trust exit status alone.

Lists

rem lists --count -o json
rem list-mgmt create "Travel"
rem list-mgmt rename "Old" "New"
rem list-mgmt delete "Name" --force

Conventions

  • Use executable task titles. Rewrite vague notes into the next concrete action.
  • Preserve user wording when they clearly want verbatim capture.
  • Split multiple unrelated actions into separate reminders.
  • Use the default list unless the user names a list or the category is obvious.
  • Do not add calendar events here; use calendar tooling instead.
  • For current date math, run date; do not guess.

Read the full file on GitHub · 102 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 102 lines · 22 tokens per session scan A 99274f991fc7

Subscribe to this mod's changes

reminders is a skill published in the GitHub repository sublimecoder/aios (2 stars, last pushed 1mo ago), licensed MIT. It adds 22 tokens to every session and 708 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to reminders, differing in 0 lines, and is treated as a copy.

Related

Other skills, from other repositories

pos-verify

Use this immediately after files are created, edited, moved, deleted, or materially rewritten inside PersonalOS. Verifies that new truth was routed to the correct owner, written in the correct file shape, and still follows POS conventions. Do NOT use for whole-vault deep audits; use system-health-check.

vincentmumme/personalos-boilerplate · 65 tokens

skillify

Use this when {{username}} asks to skillify a repeated workflow, determine whether it deserves a reusable PersonalOS skill, or harden an existing workflow into a tested resolver-reachable capability. Do NOT use for one-off notes, ordinary execution, or already-specified skill authoring; use write-skill.

vincentmumme/personalos-boilerplate · 66 tokens

write-skill

Use this when the user wants to create a new shared PersonalOS skill under skills/ or revise a specified PersonalOS skill and the scope is already clear. Do NOT use for raw workflow capture or deciding whether work should become a skill; use skillify first. Do NOT use for repo-local or agent-local skills unless…

vincentmumme/personalos-boilerplate · 78 tokens

priority-dashboard

Use this to rebuild, inspect, or temporarily steer {{username}}'s current PersonalOS priority dashboard from canonical Actions, Attention Triggers, and owner context. Do NOT use it to create, complete, or independently manage tasks; use task-manager for Action and Trigger lifecycle changes.

vincentmumme/personalos-boilerplate · 60 tokens

lint-brain

Run health checks over the brain vault - find orphan notes, broken wikilinks, missing frontmatter, stale projects, and missing cross-links. Use when asked to "lint the brain", "health check", "vault hygiene", or "/lint-brain".

michaeljauk/brain-starter · 56 tokens

ingest-article

Ingest an article from a URL or raw text into the brain vault. Extracts key knowledge, determines placement, creates or updates notes, and links to relevant projects. Use when the user shares a URL or text and wants to absorb it into their knowledge base.

michaeljauk/brain-starter · 58 tokens