CCBot

AI Agent 通知助手

macOS 菜单栏应用,监听 Claude Code / Codex CLI / JetBrains IDE 中的 AI Agent 事件, 通过系统通知和 Telegram 实时推送 — 再也不用盯着终端等了。

v1.0.8 · macOS 13.0+ · MIT License · Swift 6
CCBot 菜单栏
菜单栏面板
CCBot 通知
系统通知

使用场景

无论哪种工作模式,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
Codex CLI
OpenAI 命令行工具
notify 回调
JetBrains CC GUI
文件 IPC 监听
DispatchSource 实时响应
JetBrains ACP
Node.js stdio 代理
拦截 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
Swift 6 SwiftUI Network.framework 零第三方依赖 XcodeGen GitHub Actions CI 公证签名

让 AI Agent 自己跑,你去喝杯咖啡。

下载安装,菜单栏一键配置。
下载 CCBot