December 2025

TermSupervisor：多个 AI 编程会话的监控室

用 iTerm2 API 和 Web 仪表盘管理并行 Claude Code 会话

2025-12-06 Markdown source

最近在做项目，同时开了好几个 Claude Code 帮我写代码。

问题来了：管理它们太麻烦。要不停切窗口看状态，哪个跑完了，哪个报错了，最烦的是卡在"等待权限批准"——不点确认它就一直等着。

作为程序员，这种重复劳动必须解决。

于是周末写了个工具：TermSupervisor

做什么的？

Hook iTerm2 的 API，把所有终端窗口映射到一个 Web 页面上。用 iPad 或副屏挂着，一眼看清所有状态。

核心功能：

  • 状态用颜色区分：蓝色=运行中，黄色=等待批准，绿色=完成，红色=失败
  • 实时同步终端内容
  • 支持多屏，主屏干活，副屏监控

技术栈：

  • Python 3.12 + FastAPI
  • iTerm2 Python API
  • WebSocket 实时推送
  • 状态机检测终端运行状态

如果你也经常同时跑多个 AI Agent，可能会用得上。

自用小工具，已经开源：https://github.com/Lin-Guanguo/TermSupervisor 功能还不算完善，仍有小 bug，自有足够，慢慢优化