# Do.remind

> Install and explain DeepOrbit's local reminder delivery for timed Markdown tasks. Use when the user says "remind me", "提醒我", "到点叫我", "定时任务", mentions cron-based reminders, asks why a notification did not fire, or wants macOS notifications for tasks carrying a due date and time.

- Skill: `dull-bird/do-remind` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dull-bird/do-remind`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dull-bird/do-remind/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: dull-bird (https://skillmd.com/u/dull-bird)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dull-bird/do-remind

---


# Remind from Markdown Tasks

DeepOrbit reminders are local and private: a launchd job polls the vault every minute and delivers macOS notifications for due timed tasks. Nothing leaves the machine.

## When to use which mechanism

- **Pure time reminder** ("remind me at 7 to call Alice") → capture the task with `do.todo` (`📅` + `⏰`), then rely on `deeporbit remind`. This covers everything the user can read and complete themselves.
- **Reminder that needs agent work** ("at 5pm draft my weekly report and remind me") → schedule a one-shot agent job instead:

```bash
deeporbit cron add draft-weekly "Run do.daily and draft the weekly report" --at 2026-07-25T17:00
```

An `--at` job fires once, hands the instruction to the configured agent CLI, and auto-disables (kept for audit, not deleted).

## How delivery works

```
launchd (StartInterval 60, fires missed runs after sleep/wake)
  └─ deeporbit remind check --deliver
       ├─ due: 📅 = today, ⏰ ≤ now, task not done, not already delivered
       ├─ alerter (optional, `brew install alerter`): interactive notification
       │    [完成] marks the task done · [稍后] snoozes 10 minutes
       └─ fallback: osascript display notification (zero-dependency banner)
State: ~/.config/deeporbit/reminders.json (delivered / snoozed, idempotent)
```

Only tasks with both `📅 YYYY-MM-DD` and `⏰ HH:MM` trigger notifications; date-only tasks appear in the agenda but never pop up.

## Install and uninstall

```bash
deeporbit --vault "<vault-path>" remind install   # writes ~/Library/LaunchAgents/com.deeporbit.remind.plist and loads it
deeporbit --vault "<vault-path>" remind check --deliver   # manual run, useful for testing
```

There is no `remind uninstall`; the install output prints the exact `launchctl unload` command and plist path to remove it manually.

## Privacy note

Notification banners include the task text. On a shared or screen-recorded machine, keep sensitive wording out of task text or redact before capturing.