Skip to content
BlackKingBarOrgPublic

About

Omarchy bar plugin: type one sentence and Claude turns it into a memo or a reminder; reminders ring with a notification and a chime

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

memo

顶栏右上角的备忘铃铛:点开,写一句话,本机的 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 那一项。

About

Omarchy bar plugin: type one sentence and Claude turns it into a memo or a reminder; reminders ring with a notification and a chime

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages