顶栏右上角的备忘铃铛:点开,写一句话,本机的 Claude Code 读懂它,用工具把它存成备忘或者提醒。
到时间了弹通知、响闹钟(系统的 alarm-clock-elapsed,约 6 秒)。
- 「明天下午3点提醒我开会」「半小时后关火」「周五之前交周报」
- 「每天早上8点吃药」「每周一三五晚上8点跑步」「每隔45分钟起来活动」
- 「买牛奶」(没有时间就存成普通备忘)
- 一句话里有几件事会分别存;也能改已有的:「把吃药改成8点半」「打电话那个删掉」
- 点铃铛打开面板,输入框已经有焦点,直接打字(中文输入法正常用),Enter 交给 Claude。 Claude 处理时可以关掉面板,存好后会弹一条通知确认。
- ↓ 进入列表:j/k 移动,Enter 完成(重复提醒是「知道了」),s 稍后 10 分钟再提醒,x 删除, i 或 / 回到输入框,Esc 关闭。
- 铃铛:空心 = 没有待提醒的;实心 = 有;沙漏 = Claude 正在处理;红色响铃 = 有提醒到时间还没处理。
- 提醒的通知会一直留在屏幕上,点它打开面板。重复提醒响过后自动排到下一次。
- 电脑关着或 shell 没运行时错过的提醒,下次启动时补响(通知里写「错过了 … 的提醒」)。
面板里的「语音唤醒」开关(就是 systemctl --user enable/disable --now memo-wake)。打开后:
- 「Hi Omarchy,明天下午3点提醒我开会」一口气说完,后半句直接交给 Claude。
- 只说「Hi Omarchy」:弹出「我在听…」,铃铛变成麦克风,响一声提示音,8 秒内说要记的事。
wake.py 用自己的 pw-record 听麦克风,按音量切出一句一句,交给 omavoi 常驻的 whisper 转写
(地址从 omavoi 的 socket 拿,它重启换端口也能跟上)。开头是唤醒词才算命令,别的转写结果直接丢掉;
音频只在内存里,不落盘。按住 RightAlt 用 omavoi 听写时说的话会跳过,不会重复转写。
唤醒词按「Hai Omachi」这类念法匹配:whisper 会写成 Omachi、お待ち、おまち 等,都算。
如果你的念法总是认不出,用 ./wake.py --debug 看它听成了什么,把那个写法加到 settings.json 的
"wakeWords": ["正则", …] 里。"wakeCue": false 关掉提示音。
注意:播放有人声的音频(有声书、视频)时,每一句都会被转写一次(每句约 0.2 秒 GPU),但只有开头是唤醒词的才会执行。
面板 (Panel.qml) ──► Service.qml ──► memo.py serve ──► claude -p
│ ▲ │ 只开放 mcp__memo 工具
│ └──────────────┤
▼ ▼
~/.local/share/memo/memos.json ◄── memo.py mcp
memo.py serve:shell 里常驻的后端(三块屏幕的按钮共用一个),负责计时、响铃和调用 Claude。memo.py mcp:给 Claude 用的 MCP 工具:add_reminder、list_reminders、update_reminder、delete_reminder。- 调用 Claude 用的是本机已登录的
claude(订阅/OAuth 即可),默认 Haiku、关闭 thinking,一般 4–6 秒。 它跑在--tools ""(没有任何内置工具)、--setting-sources ""(不加载你的设置、插件、hooks)、--strict-mcp-config(只有 memo 工具)下,只能动备忘。 - Claude 根本跑不起来(找不到命令、没登录、超时)时,
memo.py里的本地规则会解析这句话,照样存下来, 面板上会写明「已按本地规则添加」和原因。
~/.config/memo/settings.json,都可省略:
{
"model": "haiku",
"thinking": false,
"timeout": 90,
"sound": "/usr/share/sounds/freedesktop/stereo/alarm-clock-elapsed.oga",
"snoozeMinutes": 10
}"sound": false 关掉提示音(换别的声音时,前面会自动垫 1 秒静音,免得蓝牙音箱刚醒时吞掉开头);"model": "sonnet" 换更强的模型(更慢);"claude" 可以指定 claude 的路径。
改完下一句话就生效,不用重启。
./memo.py ask "明天下午3点提醒我开会" # 走 Claude,和面板一样
./memo.py add "明天下午3点开会" # 只用本地规则
./memo.py parse "每周一三五8点跑步" # 看本地规则怎么理解
./memo.py list
omarchy-shell ai.bkblab.memo toggle # 打开/关闭面板,可以绑快捷键测试:python3 -m unittest discover -s tests -v(用临时目录,不碰真实数据,也不发通知)。
MEMO_DIR=<目录> 换数据目录,MEMO_DRY_RUN=1 不发通知不响铃。
这是一个 Omarchy shell 插件(ai.bkblab.memo),~/.config/omarchy/plugins/ai.bkblab.memo 是指向这里的符号链接。
- 改了
wake.py:systemctl --user restart memo-wake。调试时先停掉服务再跑./wake.py --debug(同时只能有一个在听)。 - 改了
memo.py:重启后端即可(shell 3 秒内自动拉起):pkill -f '^/usr/bin/python3 .*memo.py serve' - 改了 QML:
omarchy restart shell(顶栏会闪一下;符号链接的插件不一定能热重载)。 - 从顶栏移除:删掉
~/.config/omarchy/shell.json里ai.bkblab.memo那一项。