{"repo":"BinaryFroggy/Hopet","free":true,"listed":false,"github":"https://github.com/BinaryFroggy/Hopet","clone":"git clone https://github.com/BinaryFroggy/Hopet.git","description":"A macOS desktop AI pet that mirrors your Claude Code & Codex CLI session state in real time. 支持Claude Code和Codex CLI 的像素风AI桌面宠物，会话状态实时映射，支持导入自定义宠物素材。","language":"Swift","stars":62,"topics":["agent","ai-agent","ai-assistant","appkit","claude-code","codex","codex-cli","coding-agent","desktop-app","desktop-pet"],"license":"MIT","category":"ai-agents","readme_excerpt":"简体中文 · English Hopet 一只常驻 macOS 桌面的 AI 宠物，用动画和气泡显示 Claude Code / Codex CLI 正在思考、执行工具、等待确认、请求权限或完成任务，并通过桌面宠物与灵动岛提醒你关注 agent 进展。 --- 项目介绍 Hopet 是一只常驻 macOS 桌面的 AI 编程宠物，它把 Claude Code / Codex CLI 的会话状态变成可见、可感知的桌面反馈：思考、执行工具、等待确认、请求权限、完成或失败，都能通过宠物动画、气泡提示和灵动岛 / 顶部状态条表现出来。 它不是另一个聊天窗口，而是一个轻量的工作陪伴层，让开发者在写代码时不用频繁切回终端，也能直观看到 AI agent 当前在做什么、是否需要你介入，以及一次会话是否顺利推进。 Hopet 让本来隐藏在命令行里的 agent 生命周期变得更清楚、更亲近，也让长时间的 AI 协作多了一点秩序和温度。 发布版默认使用内置的 Hopi 主题 ——一只可爱的像素风小海豹，每个状态对应一段动画；如果你想换一只自己的宠物，可以准备一个名字和 8 张 GIF 图片，也可以直接导入 Codex pet 的文件夹或 ZIP 包。 支持的 AI 工具 Hopet 通过 agent CLI 的生命周期 hook 工作，目前覆盖以下 4 种用法： - Claude Code ——在任意终端里跑 claude CLI - Claude Code for VS Code ——官方 VS Code 扩展 - Codex CLI ——在任意终端里跑 codex CLI - Codex VS Code Extension ——官方 VS Code 扩展 由于一切都走 /.claude/settings.json 和 /.codex/hooks.json 这两份 hook，所以宿主不影响行为：Apple Terminal、iTerm2、Ghostty、Warp、VS Code / Cursor 的内嵌终端等任一环境表现一致。 不支持：浏览器版 Claude（claude.ai）；以及非 Claude Code / Codex 的 AI agent（GitHub Copilot Chat、Gemini CLI、Aider 等）。 功能 会话感知 - 8 态状态机 ，覆盖 agent 的每一次有意义的转换： idle 、 responding 、 thinking 、 tool-use 、 permission-prompt 、 ask-user 、 completed 、 error-interrupted - 多 session 聚合 ——所有活跃 session 共用一只宠物，宠物始终呈现优先级最高的那个状态（AskUser Permission Error Tool Thinking Responding Completed Idle） - Leader 高亮 ——驱动当前宠物状态的那个 session 会被显眼地标出来，让你一眼看清\"是谁在找我\" Hook 集成 - 一键安装 / 卸载 Claude Code 与 Codex CLI 的 hook settings，采用安全的 JSON merge，绝不覆盖你已有的 hook - Unix Domain Socket IPC ，所有从 CLI helper 进入 App 的事件都走长度前缀 JSON 帧 - hopet-emit CLI 工具 ，完整支持 --require / --exclude / 点号","default_branch":null,"files":null,"tree":[],"storefront":"/r/BinaryFroggy","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/BinaryFroggy/Hopet/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}