PetDeck：把 Claude Code 的运行状态变成桌面宠物

使用 AI 编程代理时，我们经常需要切回终端确认它是在思考、读取文件、修改代码，还是停下来等待确认。完整仪表盘可以展示很多信息，但也会占据额外屏幕空间。

PetDeck（仓库名 pet-tty）选择了另一种方式：把代理状态放进一个常驻桌面角落的小宠物里。

项目地址：https://github.com/Wanbinyu/pet-tty

当前版本为 v0.3.2，以 Windows 为主要平台，Release 提供 EXE 和 MSI 安装包。

它能显示什么

PetDeck 通过气泡和动画展示 Claude Code 当前正在进行的活动，例如：

• 正在思考或生成回答
• 正在读取、编辑文件或调用工具
• 等待用户输入或审批
• 多个会话同时存在时的会话栈
• Claude Code 是否在线、桥接是否连接

工具状态具有短时间粘性，较长的读取或编辑操作不会频繁闪回空闲状态。界面支持中文和英文，也支持皮肤、像素小人以及动画 Sprite 导入。

它是怎么连接 Claude Code 的

桌宠使用 Tauri 2、Vite、TypeScript 和 Rust 构建。本机桥接服务监听 127.0.0.1:7788，Claude Code Hooks 把会话和工具状态发送到本机桥，再由桌宠更新界面。

数据默认只在本机通信，桥接限制请求大小和允许的浏览器 Origin。需要更严格的写入边界时，还可以设置 PETDECK_BRIDGE_TOKEN。

使用方式

普通用户可以从 Release 下载 PetDeck_0.3.2_x64-setup.exe 或 MSI：

https://github.com/Wanbinyu/pet-tty/releases/tag/v0.3.2

从源码安装 pettty 命令：

git clone https://github.com/Wanbinyu/pet-tty.git
cd pet-tty
npm install
powershell -ExecutionPolicy Bypass -File scripts/install-pettty.ps1

新开终端后运行：

pettty
pettty hooks

随后完全退出并重新打开 Claude Code。没有 Claude Code 时，也可以执行 pettty test 发送测试状态。

适合什么场景

PetDeck 不是另一个聊天客户端，也不读取你的 API Key。它更像一个轻量状态窗口：当终端被其他窗口遮住时，仍然可以快速判断代理是否工作、正在做什么、是否需要你回来处理。

如果你喜欢桌宠，也希望 AI 编程过程更直观，可以下载 Release 体验，或者为项目制作新的皮肤和动画。