经常使用多个终端处理 claude/codex，我做了一个状态悬浮窗

在平常工作中，经常会同时开几个 Claude Code 、Codex 会话，之后就会发现一个问题：很难及时知道每个会话的状态，是否需要人工进行接入，或者任务是否已经完成。

尤其是在使用 tmux 的时候，这个情况会更加明显，只能挨个切过去看。检查得频繁，会打断手头的工作；检查得少，又可能让某个会话在确认提示上等很久。

于是做了 SessionMonitor，一个用于集中查看 Claude Code / Codex 会话状态的悬浮窗工具，目前只能在 macos 上运行。

功能点如下：

• 查看会话状态：工作中、需要授权、等待输入、完成未读、空闲等状态集中展示。


• 保留完成提醒：完成的会话带有未读标记，可以等手头的事情处理完再看。


• 跳回对应会话：点击列表中的会话跳转到终端，tmux 会话可以定位到对应窗格。


• 按需接收通知：授权、输入和完成三类通知分别设置，不必全部开启。


• 随时收起：不需要看列表时可以收起成胶囊，也可以用 ⌥⌘S 显示或隐藏悬浮窗。

状态主要来自 Claude Code/Codex 提供的 hook 事件，会话文件用于补充信息，transcript 用于提取回复摘要。App 里面提交了安装 hook 的按钮，如果不安装对应的 hook ，那么只能看到运行中和空闲状态，无法获取其他状态。

使用上，安装应用后，打开 设置 → 集成，为 Claude Code 或 Codex 安装 hook 即可。安装前会备份配置，并保留其他工具已经添加的 hook 。Codex 还需要在会话中输入 /hooks，批准对应条目；安装后重启已打开的 Codex 会话。

通知需要系统授权，终端标签页跳转可能需要自动化权限。tmux 窗格定位需要安装 tmux ；能否精确跳转，也取决于终端和会话提供的定位信息。

如果你平时也会同时开几个 Claude Code/Codex 终端，可以试试，如果觉得好用，可以点个 star 。

项目/下载地址： https://github.com/adoom2017/session-monitor