Cuckoo — Sistema de Lembretes para Claude Code
driversti/claude-cuckoo
Tickler file para Claude Code — lembretes que reaparecem na sessão certa
Ver no GitHubPlugin que implementa um sistema de lembretes durável e baseado em sessão para Claude Code, armazenando tarefas agendadas em arquivos locais e as apresentando na próxima sessão quando o prazo chegar. Usa um hook de início de sessão que lê um índice mínimo, garantindo custo quase zero em tokens quando nenhum lembrete está vencido.
Instalação
npx convez-ai driversti/claude-cuckoo1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Agendar lembretes pessoais e recorrentes sem perder tarefas entre sessões
- Gerenciar backlog de pequenas tarefas por projeto ou globalmente
- Implementar sistema de lembretes locais sem dependências externas ou APIs
Veredito

Solução prática e leve para quem trabalha com Claude Code e precisa gerenciar lembretes duráveis. O design baseado em arquivos locais elimina dependências externas, mas a apresentação vinculada a mensagens (não alertas em tempo real) exige disciplina do usuário.
README
A tradução para o português deste README ainda está na fila.
Cuckoo 🐦
🇬🇧 English · 🇺🇦 Українська
A durable personal calendar for Claude Code. Set a reminder for a future date (optionally a time), and Cuckoo brings it back the next time you start a Claude Code session on or after that date — like a cuckoo clock popping out at the right moment. It's a tickler file for Claude Code.
Reminders live in plain files, so they survive restarts. When nothing is due, Cuckoo costs you essentially zero context tokens.
How it works
- A SessionStart hook runs a tiny command (
cuckoo check) at the start of every session. It reads a small index and prints any due reminders — or stays completely silent. - A
/cuckoo:schedulecommand lets you add, list, complete, and reschedule reminders. - Reminders are stored in two tiers:
- 🌍 Global —
~/.claude/cuckoo/— personal, works in any project. - 📂 Project —
<your-repo>/.cuckoo/— tied to a specific repo (git-ignored by default).
- 🌍 Global —
Session-triggered, not an alarm clock. Cuckoo can't push to your phone, and it is not a terminal popup. At session start the hook hands any due reminders to Claude, which announces them in its first reply once you send a message — so a brand-new session you just stare at (without typing anything) shows nothing until you say something. A time of day is the earliest surfacing moment, not a real-time alert. (Calendar/push integration is on the roadmap.)
Install
/plugin marketplace add driversti/claude-cuckoo
/plugin install cuckoo@cuckoo
Then restart Claude Code (or run /reload-plugins).
Usage
/cuckoo:schedule add tomorrow "email the tax form"
/cuckoo:schedule add 2026-07-01 09:00 "quarterly review"
/cuckoo:schedule add next friday "call the dentist" --global
/cuckoo:schedule list
/cuckoo:schedule done call-the-dentist
/cuckoo:schedule reschedule quarterly-review "next monday 8am"
- Dates resolve in your local timezone; natural language ("tomorrow", "next friday 9am", "in 3 days") works.
- Default tier is global. Inside a git repo, if you don't pass a flag Cuckoo asks whether to
scope the reminder to the repo (project) or keep it global — pass
--global/--projectto skip the prompt.
When a reminder is due, your next session opens with a note like:
⏰ CUCKOO — scheduled task(s) due
• [global] call-the-dentist (due 2026-06-20) -> ~/.claude/cuckoo/call-the-dentist.md
Claude reads the task, brings it up, offers to act on it, then asks whether to mark it done or reschedule.
Why near-zero token cost
The SessionStart hook runs in your shell, not in the model. It reads only a tiny index
(date · status · slug) and prints nothing unless something is due. The full text of a reminder
lives in its own file and is read only on the day it fires. An idle session pays only for the
one-line command description.
Data & privacy
- Everything is local files. No network, no telemetry.
- Project reminders live in
<repo>/.cuckoo/, which ships with a.gitignore(*) so your personal reminders are never committed.
Development
# Load the plugin locally without installing:
claude --plugin-dir /path/to/claude-cuckoo
# After edits:
/reload-plugins
# Run the test suite (zero dependencies):
bash tests/run.sh
The data layout and CLI:
~/.claude/cuckoo/ # global tier
├── _index.md # DUE STATUS SLUG (tiny; the hook reads only this)
└── <slug>.md # the reminder body (read only when due)
<repo>/.cuckoo/ # project tier (same layout, + .gitignore '*')
bin/cuckoo check | list | dir | add | remove | done | reschedule
Roadmap
- Google Calendar two-way sync — real device push notifications.
- In-session precision timer — fire at the exact minute while a session is open.
- Recurring reminders, snooze.
License
MIT © 2026 Yurii Chekhotskyi