@zy5669/agent-notifier
v1.5.0
Published
Standalone installer/uninstaller for task-completion notifications of kscc (Claude Code), OpenAI Codex and Claude Code: PowerShell hook scripts + sounds + hook registrations. Windows only.
Maintainers
Readme
@zy5669/agent-notifier
Windows 下一键安装/卸载 AI 编程 CLI 的任务完成通知(声音 + 系统通知弹窗)。
支持的 CLI(三端):kscc(Claude Code)、OpenAI Codex、Claude Code。
npm install -g @zy5669/agent-notifier
agent-notifier install
agent-notifier test命令
| 命令 | 作用 |
|---|---|
| agent-notifier install | 三端全装:hook 脚本 + 声音文件装到 ~/.agent-notifier/hooks/,注册到各 CLI 配置 |
| agent-notifier install --kscc | 只装 kscc(--claude / --codex 同理单端安装) |
| agent-notifier uninstall | 卸载(只删自己的条目,第三方 hook 如 gitnexus 保留) |
| agent-notifier status | 查看安装/注册/静音状态 |
| agent-notifier mute 1h | 定时静音(支持 30m / 2d / "until 17:00",到期自动恢复) |
| agent-notifier pop off | 只关弹窗,声音保留(pop on 恢复) |
| agent-notifier test | 走真实管道发一条测试通知 |
| agent-notifier logs | 查看通知日志(仅元数据) |
设计
- 零依赖纯 Node,单文件 CLI
- 通知 = WinRT toast(保留在通知中心)+ Windows 声音,无需外部 exe
- 幂等:重复 install 内容不变时零写入,不产生任何备份文件
- 条目按
agent-notifier-on-标记精确剥离,不误伤其他工具的 hook - 隐私:日志只记时间/项目/摘要,不记提示词内容
仅支持 Windows(PowerShell 5.1+)。MIT License。
