reminder

Reminder -- Reminder manager

Manages reminders stored in ~/.claude/reminders.json.

Commands

Detect the action from the arguments or the context:

• /reminder or /reminder list → list active reminders
• /reminder add <date> <message> → add a reminder
• /reminder done <index> → mark as done (kept in the file as history)
• /reminder history → list completed reminders

Format of reminders.json

[
  {
    "date": "2026-06-16",
    "project": "my-project",
    "message": "Reminder description"
  },
  {
    "date": "2026-06-01",
    "project": "my-project",
    "message": "A completed reminder",
    "done": true,
    "completed_at": "2026-06-02"
  }
]

Entries without a done field are active. Completed entries keep done: true and completed_at (the YYYY-MM-DD date they were marked done).

Actions

List

Read ~/.claude/reminders.json, skip entries with done: true, and display the active reminders sorted by date. Indicate which ones are overdue, due today, or upcoming. Use 1-based indexes counted over the active reminders only (these are the indexes done accepts).

Add

The user provides a date and a message. Accepted date formats:

• Absolute date: 2026-06-16, June 16, 06/16/2026
• Relative date: in 2 weeks, tomorrow, next Monday

Convert to YYYY-MM-DD format before saving. The project field is optional -- if you are inside a project, use the current directory name.

Read the file, add the reminder, rewrite the file.

Done

The user provides an index (1-based, over the active reminders) or part of the message. Read the file, find the matching active reminder, set done: true and completed_at to today's date (YYYY-MM-DD), rewrite the file. Do NOT remove the entry: it stays as history. Confirm the completion.

History

Read the file, keep only entries with done: true, and display them sorted by completed_at (most recent first), showing the original due date, the completion date, the project and the message. If the user asks to permanently delete history entries, that is the only case where entries are actually removed from the file (confirm first).