我构建了 mokkan:让提醒在 Claude Code、Codex 和终端会话之间跟随你
Mokkan 是一个开源 Claude Code mod 和 CLI 工具,在服务器上维护一份提醒清单,让 Agent 查询到期事项,而不是依赖记忆。在 Claude Code 中,/mokkan 会在转录旁打开一个面板,以提示消息显示到期提醒,不会将内容注入对话;Codex 和任何终端都能读取同一份清单。它支持推送、定时提醒、打印和 pop,未确认的定时项目会通过电子邮件发送。CLI 和插件采用 MIT 许可,可使用预付费托管额度或自托管服务器,并通过插件市场或 npm 安装。
关于这个 mod
Mokkan 解决的是 Agent 工作阶段之间忘记提醒和 TODO 的问题。它在服务器上维护一份提醒清单,每个工作阶段都会查询这份清单,而不是指望模型记住。在 Claude Code 中,mod 的 /mokkan 命令会在转录旁打开一个面板,显示用户的待办堆栈;提醒到期时会出现提示消息,不会有任何内容注入对话。Codex 会通过一个 skill 在每项任务开始和结束时检查同一份清单,任何终端也都能看到它。在笔记本电脑上推送的笔记,几秒后就会出现在台式电脑上。在 Claude for Desktop 中,这个面板同样可用,不过体验相近而不完全相同。CLI 用法包括 mokkan push "check the flaky login test"、mokkan in 2h "ask Maria about the release notes"、mokkan 打印清单,以及 mokkan pop 完成最上面的项目。提醒会一直亮着,直到从任意工作阶段确认;定时提醒如果几分钟内没有确认,就会通过电子邮件发送,避免笔记静默消失。这个项目使用 Opus 5.5 在 Claude Code 中构建,后来又使用 Fable 5.1;54 次提交中有 47 次由 Claude 共同完成。面板本身是一个在工作阶段内部运行的小型 TypeScript mod,能够看到工作阶段事件并绘制面板。CLI 和插件以 MIT 许可开源;托管服务器使用预付费额度,注册时提供 50 个免费额度,之后 €5 可购买 500 个额度。添加一条笔记消耗 1 个额度,发送一封电子邮件时消耗 1 个额度,列出或确认提醒免费;用户也可以将它指向自己的服务器。使用 /plugin marketplace add vicmpen/mokkan 和 /plugin install mokkan@mokkan 安装,或执行 npm install -g @vicmpen/mokkan-cli。GitHub:https://github.com/vicmpen/mokkan Site:https://mokkan.dev
安装
安装方法请查看原始来源。
原文 / README
If you work in a lot of agent sessions, you've probably hit this: you tell Claude "remind me to check the flaky test later", or you create TODO lists in every project and eventually you forget. Every session starts blank, and the model only checks on something if it happens to think of it. I built mokkan as a small fix for that. It's Claude Code Mod and a CLI-tool that keeps one reminder list on a server. Every session asks the server what's due, instead of the model trying to remember. Behold, this isn't an agent-first functionality, but a human one, allowing us, the users to not alt-tab to various note taking apps for a simple TODO, or reminder. The skill teaches the agent to use the tool though :) In Claude Code, /mokkan opens a pane beside the transcript with your stack. A reminder that comes due shows up there as a toast; nothing gets injected into the conversation. Codex checks the same list at the start and end of each task through a skill, and any terminal sees it too. Push a note on your laptop, it's on your desktop a few seconds later. In Claude for Desktop the pane works too, but the platform differs a bit from Claude Code, so the experience is close but not identical. How it works in the CLI mokkan push "check the flaky login test" adds a todo mokkan in 2h "ask Maria about the release notes" schedules a reminder mokkan prints the list, mokkan pop finishes the top one Nothing closes until you say so A reminder stays lit until you acknowledge it, from any session. If a scheduled one comes due and nobody acks it within a few minutes, it's emailed to you. So notes don't silently disappear. How I built it The whole thing was built in Claude Code, with Opus 5.5 and later Fable 5.1. Of the 54 commits in the public repo, 47 are co-authored by Claude. The loop was the same for every feature: I describe what I want, Claude asks me the questions it needs answered, then writes a design spec and a step-by-step implementation pments the plan task by task with tests (vitest for the CLI, claude plugin test for the pane), and I review the diff and try the pane and the terminal UI by hand, since that part doesn't test well automatically. One thing I'd recommend to anyone doing this: Clamd` with every decision it made on its own,numbered and with the reason, separate from the decisions I made explicitly. When something feels off later, I can find the assumption behind it instead of guessing. The pane itself is a Claude Code mod: a small Typruns inside the session, sees its events and draws the pane. So it was built with Claude Code and for Claude Code. Cost The CLI and plugin are open source (MIT). The hosted server runs on prepaid credits: 50 free on signup, then €5 for 500. Adding a note costs 1 credit, an email costs 1 crly sent, and listing or acknowledging is free. You can also point it at your own server. Install /plugin marketplace add vicmpen/mokkan /plugin install mokkan@mokkan or for the terminal: npm install -g @vicmpen/mokkan-cli GitHub: https://github.com/vicmpen/mokkan Site: https://mokkan.dev Happy to answer questions. submitted by /u/Cl33t_Commander [link] [comments]
其他同名作品
- 我构建了 mokkan:在 Claude Code、Codex 和终端会话之间跟随您的提醒Cl33t_Commander · ★ 0
