reminderlisted
Install: claude install-skill JeremieSamson/claude-code-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
```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