pixtuoid：终端像素办公室看 AI 代理

项目简介

同时跑好几个 AI 编程代理时，往往要在多个终端之间来回切换，才能知道谁卡住了、谁在等你确认权限、谁十分钟前就干完了。pixtuoid 把这些会话放进一间俯视视角的像素画办公室里：每个会话都是一个坐在工位上的角色，工作时敲键盘，需要你时举起 ?，干完活就趴下打盹。

它由 Rust 编写，基于 ratatui，在终端里运行，支持 Claude Code、Codex CLI、Copilot CLI、opencode、Cursor CLI、Kimi Code CLI 等多种代理 CLI。

主要功能

• 剖面办公室：支持显示图片的终端（kitty、iTerm2、SIXEL）会绘制细节丰富的剖面像素视图，其他终端则用文本块绘制经典样式。
• 多代理与多层楼：每个代理会话有自己的工位，一层坐满后自动开新楼层。
• 分区办公空间：工位区、会议休息区、茶水间等，而不是一排排相同的桌子。
• 动画角色：角色会打字、举 ? 求助、在 z 字下打盹，也会在工位间走动。
• 团队配色：同一工作目录下的代理使用相同颜色，方便看出谁和谁在协作。
• 显示器辉光：显示器按当前使用的工具发光，例如 Edit 蓝色、Bash 橙色、Read 青色。
• Token 计量：会话消耗 token 时桌面上会堆起纸张，在 250K、2M、16M 时增长，悬停可看精确数值。
• 代理树面板：按 <kbd>Tab</kbd> 查看每个代理运行的 CLI 和当前状态。
• 办公室宠物：每层楼一只猫或狗，会在工位、茶水间、沙发之间活动，闲置代理附近会睡觉，点击可以抚摸并飘出像素爱心。
• 办公室氛围：窗外日夜交替、天气变化，不同主题给办公室换一套样子。
• Lofi 配乐：完全用代码生成的 lofi 背景音乐，会跟随办公室的时间、天气和活跃度变化，<kbd>m</kbd> 静音，<kbd>+</kbd>/<kbd>-</kbd> 调音量。
• 浮动桌面窗口：pixtuoid floating 在桌面（而不只是终端里）打开一个无边框、置顶的办公室窗口。

安装与使用

Homebrew（Linux、macOS 或 WSL2）：

brew install pixtuoid

npm（任意系统）：

npm install -g pixtuoid

安装后：

1. 运行 pixtuoid。
2. 按 <kbd>s</kbd> 连接你的代理 CLI，pixtuoid 会自动完成设置；若出问题可用 pixtuoid doctor 检查。
3. 在另一个终端启动该代理，一秒内就会有一位同事从电梯走进办公室。

常用按键：<kbd>Tab</kbd> 打开代理面板，<kbd>t</kbd> 切换主题，<kbd>m</kbd> 开关声音，点击角色可把它的终端切到前台，<kbd>?</kbd> 查看其余按键。

此外还提供 Cargo、预编译二进制和 Debian 包（.deb）等安装方式，详见官网安装指南。主题可按 <kbd>t</kbd> 实时预览并保存；每层工位数量、宠物名字、剖面或经典样式等设置默认放在 ~/.config/pixtuoid/config.toml。

注意事项

• Windows 支持仍属实验性质，测试有限，二进制未签名。
• pixtuoid 不收集遥测，默认完全本地运行，不主动建立外部连接；只有运行 pixtuoid serve 时，才会把代理状态、模型、用量和仓库名（不含路径、提示词和对话记录）发送到你在局域网中配对过的设备。
• 原理上，它通过安装的一个轻量 hook（不会阻塞你的代理）以及代理自身的会话日志来了解每个代理在做什么。
• 项目采用 MIT 许可证。

---

本作品整理自 GitHub 开源项目 pixtuoid/pixtuoid，原作者 @pixtuoid，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。