Claude Memory Reminder banner
moyunliuyin moyunliuyin

Claude Memory Reminder

Development community

Description

Persistent tiered memory & reminder notebook skill for Claude Code and codex. Zero-dependency bash hook, multi-window dedup, natural-language reminder add/complete/cancel.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

**English** | [中文](README.zh-CN.md)

Claude Code Memory & Reminder Skill

**Persistent tiered memory & reminder notebook for [Claude Code](https://claude.com/claude-code) and [OpenAI Codex CLI](https://github.com/openai/codex).**

So your assistant actually remembers what matters and gently reminds you of things you promised yourself.

[![ShellCheck](https://github.com/moyunliuyin/claude-memory-reminder/actions/workflows/shellcheck.yml/badge.svg)](https://github.com/moyunliuyin/claude-memory-reminder/actions/workflows/shellcheck.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Release](https://img.shields.io/github/v/release/moyunliuyin/claude-memory-reminder)](https://github.com/moyunliuyin/claude-memory-reminder/releases) [![Platforms](https://img.shields.io/badge/platforms-Claude%20Code%20%7C%20Codex%20CLI-blueviolet)](#install-for-codex-cli)

git clone https://github.com/moyunliuyin/claude-memory-reminder ~/.claude/skills/claude-memory-reminder

Features

  • Tiered memory — importance (H/M/L) × recency (vivid/distilled/archive); important configs stay fresh past 30 days, one-off noise drops out early
  • Scheduled triggers — daily boundary check; monthly verified refresh (default: 1st); twice-monthly pattern extraction (default: 15th + last day)
  • Reminder notebook — add / complete / cancel via natural language in chat ("remind me to X on May 10", "X done"); supports [earliest:HH:MM] for time-of-day gating
  • Multi-window dedup — a cooldown stamp (default 8h) prevents repeated reports across parallel CLI windows; saves ~300–500 tokens per extra window
  • Zero dependencies at runtime — the hook script uses only bash + grep + date. Local validation can optionally use Python and ShellCheck

How it works

Every Claude Code session runs a `SessionStart` hook that either:

  1. REQUIRED — first window in the cooldown win