codex-pushplus-notify
v0.3.3
Published
Cross-platform PushPlus App notifications for Codex CLI turn completion
Downloads
1,183
Maintainers
Readme
codex-pushplus-notify
为 Codex CLI 的每次 Agent 回合完成发送 PushPlus 通知. 每条消息会同时发送到 PushPlus App 和浏览器扩展渠道. 支持 Windows 11 和 Linux, 需要 Node.js 18 或更高版本.
安装
发布到 npm 后:
npm install --global codex-pushplus-notify
codex-pushplus-notify init本地测试此包:
npm install --global .
codex-pushplus-notify init安装过程会请求 PushPlus Token, 将其写入当前用户的私密配置目录, 并在 ~/.codex/config.toml 中配置 notify 回调. 安装完成后会立即发送中文 PushPlus App 测试通知. Linux 上的 Token 文件权限为 600.
也可用环境变量进行非交互安装, 避免 Token 出现在 shell 历史中:
export PUSHPLUS_TOKEN='your-token'
codex-pushplus-notify initPowerShell:
$env:PUSHPLUS_TOKEN = 'your-token'
codex-pushplus-notify init
Remove-Item Env:PUSHPLUS_TOKEN命令说明
codex-pushplus-notify init
codex-pushplus-notify on
codex-pushplus-notify off
codex-pushplus-notify test
codex-pushplus-notify removeinit 会交互式请求 PushPlus Token, 覆盖已有 Token, 启用提醒并发送测试通知.
on 会使用已保存的 Token 开启提醒并发送测试通知. 若尚未执行 init, 它会提示先完成初始化.
off 会关闭 Codex 回合完成提醒, 但保留 Token. 之后执行 on 即可恢复, 无须再次输入 Token.
remove 会删除该工具写入的 notify 配置和保存的 Token, 并在修改前创建 config.toml.pushplus-notify.bak 备份.
安全说明
- 不要将 PushPlus Token 写进
AGENTS.md, 仓库或命令历史 notify在每次 Agent 回合完成时触发, 不等同于完整交互式会话退出- 每条消息会分别使用
"channel": "app"和"channel": "extension"各发送一次 - 自动提醒标题为本地时间加
Codex 回复完成, 正文仅包含设备, 操作系统和用户名
