CCBot
AI Agent 通知助手
macOS 菜单栏应用,监听 Claude Code / Codex CLI / JetBrains IDE 中的 AI Agent 事件, 通过系统通知和 Telegram 实时推送 — 再也不用盯着终端等了。
v1.0.8 · macOS 13.0+ · MIT License · Swift 6
菜单栏面板
系统通知
使用场景
无论哪种工作模式,CCBot 都能帮你守住关键时刻
长任务后台跑
让 Agent 自主重构代码、跑测试,任务完成第一时间通知你,不用反复切窗口查看。
权限卡住时
Agent 需要批准执行危险操作?CCBot 立刻推送,不让权限弹窗默默阻塞进度。
多项目并行
同时在多个终端跑 Agent 任务,所有项目的状态汇聚到一个通知流,一目了然。
功能
覆盖从通知到集成的完整链路
系统通知
任务完成、权限请求、用户输入、一般通知,4 类事件实时推送到 macOS 通知中心。
Telegram 推送
配置 Bot Token + Chat ID,通知同步到 Telegram。自动重试、指数退避,离开电脑也不错过。
一键安装 Hook
自动写入 ~/.claude/hooks/ 和 ~/.codex/hooks/,注册到配置文件,即装即用即卸。
JetBrains IDE 集成
CC GUI 文件监听 + ACP Proxy 双模式。1.5s 智能延迟过滤自动批准操作,避免通知轰炸。
安全 & 去重
本地 HTTP 服务 Bearer Token 认证,3s 节流 + 6s 指纹去重,干净准确不打扰。
自动更新检查
每次打开菜单自动对比 GitHub Releases 最新版本,发现更新一键跳转下载。
快速开始
三步完成配置
1
下载安装
从 GitHub Releases 下载 DMG,拖入 Applications
›2
安装 Hook
菜单栏点击安装按钮,一键注册到 Claude Code / Codex
›3
开始使用
Agent 事件自动推送到通知中心,可选配置 Telegram 远程推送
集成
覆盖主流 AI 编程工具链
Claude Code
CLI / Desktop / Web
Notification + Stop Hook
Notification + Stop Hook
Codex CLI
OpenAI 命令行工具
notify 回调
notify 回调
JetBrains CC GUI
文件 IPC 监听
DispatchSource 实时响应
DispatchSource 实时响应
JetBrains ACP
Node.js stdio 代理
拦截 JSON-RPC 权限请求
拦截 JSON-RPC 权限请求
架构
Claude Code ── Hook ────────▶ HookServer (:62400) ──▶ macOS 通知 ──▶ Telegram Codex CLI ── notify ──────▶ HookServer (:62400) ──▶ macOS 通知 ──▶ Telegram CC GUI ── 文件 IPC ──▶ CCGUIWatcher ──────────▶ macOS 通知 (DispatchSource) ──▶ Telegram JetBrains ── stdio ──▶ ACP Proxy ── POST ──▶ HookServer