IvanWng97/pixtuoid

Terminal pixel-art office for AI coding agents

解决的问题

同时运行多个 AI 编程代理通常需要不断在终端窗口之间切换，以跟踪进度、识别谁卡住了，或者查看谁需要用户权限。pixtuoid 通过提供一个单一的、直观的视觉仪表板解决了这个问题，该仪表板将每个代理会话表示为虚拟办公室中的像素艺术角色。

工作原理

pixtuoid 通过 hook shim 和 JSONL 转录监听与代理 CLI（如 Claude Code、Codex 等）集成。这些事件通过 Unix 套接字（或 Windows 上的命名管道）发送到更新办公室状态的 reducer，然后作为终端或悬浮桌面窗口中的半块（half-block）像素艺术进行渲染。

适用对象

使用多个 AI 编程代理，并希望以低开销、可视化方式监控其状态、Token 使用量和活动工具，而无需手动检查每个终端的开发者。

亮点

  • 多代理可视化：每个代理会话都会在拥有隔间和休息室等不同区域的多层办公室中分配一个办公桌。
  • 实时状态指示器：角色根据活动（打字、等待或睡眠）进行动画处理，显示器根据正在使用的工具发出不同颜色的光（例如：Edit 为蓝色，Bash 为橙色）。
  • Token 追踪：办公桌上的视觉“纸堆”会随着会话消耗 Token 而增长，悬停工具提示提供准确的总数。
  • 代理仪表板：可折叠的树状视图提供代理、其关联的 CLI 以及工具调用次数的详细明细。
  • 氛围细节：包括合成的 lofi 配乐、动态天气、昼夜循环和可交互的办公室宠物。
  • 非阻塞集成：使用始终以 0 状态退出的 hook shim，确保仪表板永远不会干扰代理的运行。