Hall Monitor Vibe 项目

项目简介

Hall Monitor 是一款专为 Claude Code 与 Codex 编码代理设计的实时监控工具，由独立开发者 Hitesh Bandhu 开源。它通过一个跨终端、菜单栏与 MacBook 刘海的统一视图，让你在切换任务的同时也能一眼看清所有编码代理的运行状态、所在项目、当前工具与上下文消耗。无论是本地 Mac、远程开发机还是 GPU 服务器，都能在一块面板上统一观察，被作者称为编码代理的看门人。

核心功能

• 实时看板：自动汇总 Claude Code 与 Codex 的所有会话，将卡片按需要你、工作中、空闲分组，需要介入的卡片会以琥珀色脉冲提醒，并解释原因（权限确认、提问、报错等）；
• 跨机器聚合：通过纯 SSH 连接一台或多台远程主机，把笔记本、开发机、GPU 服务器上的代理合并到同一块看板上，掉线时顶部状态条会以红色标注；
• MacBook 刘海与菜单栏集成：在刘海两侧显示代理状态小图标，悬停可看飞行中的代理，需要时面板自动从刘海滑出；菜单栏提供原生 macOS 菜单与通知中心集成；
• 使用量统计：自动读取 Claude Code 与 Codex 自带的日志生成用量账本，统计代理小时数、缓存命中率、按周分布的使用习惯，以及计划额度的实时消耗；
• 只读安全模型：只读取会话元数据与日志末尾，从不发送提示、批准动作或与代理对话；读取 Claude 额度时启用安全模式（无 hooks、MCP、插件、工具），并在用完即删除该会话记录。

技术实现

Hall Monitor 由 Go 编写，提供 macOS/Linux 通用二进制与基于 SwiftUI 的 macOS 应用（要求 macOS 14+）。看板上集成活跃用户统计由 claude agents --json、Claude 的 ~/.claude/sessions/*.json 会话记录与实时 transcript 提供；Codex 则通过实时进程与会话日志、以及运行的 Codex app-server 抓取。终端中使用 kitty graphics 协议（Ghostty、cmux、kitty、WezTerm）直接渲染供应商 logo，其他终端显示彩色字符徽标；远程主机通过持久 SSH 流式推送相同的元数据，无需部署守护进程或开放端口。系统占用低：菜单栏常驻约 1% CPU，打开看板时增加数个百分点，所有数据全部本地保存，不上传任何遥测。

快速上手

1. 安装：通过 Homebrew 安装 CLI brew install hiteshbandhu/tap/hallmonitor，或安装带刘海/菜单栏的 Mac 应用 brew install --cask hiteshbandhu/tap/hallmonitor-app（macOS 14+），也可以从 GitHub Releases 下载二进制或 go install 自行编译；
2. 启动看板：在终端运行 hallmonitor 立即打开 TUI 看板，想先看效果可用 hallmonitor --demo 加载示例数据；
3. 加入远程主机：先在服务器上安装 hallmonitor，然后运行 hallmonitor --host dev@gpu-box --host build-01，或把主机列表写入 ~/.config/hallmonitor/hosts；
4. 启用 Claude 实时额度：在终端会话里执行一次 hallmonitor statusline --install，将状态行指向 hallmonitor，Claude 每次回复后自动刷新 5 小时与每周额度。

适用人群

• 同时管理多个 Claude Code 或 Codex 会话的重度 Agent 用户；
• 拥有 MacBook 与远程 GPU 服务器、开发机的全栈与 AI 工程师；
• 关心计划额度消耗、希望在超额前收到提醒的个人开发者；
• 需要让团队一眼看到当前自动化编码进度的小组负责人。

项目链接

• 仓库：https://github.com/hiteshbandhu/hallmonitor
• 安装与文档：https://github.com/hiteshbandhu/hallmonitor#install
• 发布下载：https://github.com/hiteshbandhu/hallmonitor/releases