Skip to content

AgentHalo 1.0.0

Choose a tag to compare

View all tags
@ai-martin-lau ai-martin-lau released this 19 Sep 09:25
· 30 commits to main since this release
v1.0.0
2d92271

AgentHalo 桌面版的第一个公开发布。桌宠会跟着你本机 AI 工具的状态动起来：在思考、在调工具、需要你回话、干完了，各有对应的动作和提示音，20 套角色可选。

支持 Claude Code、Codex、Cursor、Gemini CLI、Qwen Code 等命令行工具，以及网页版的 ChatGPT / Claude / Gemini。

安装

npx agenthalo

会自动识别芯片、下载对应的包、核对校验和、装进 /Applications 并打开。需要 Node 18 以上。

装到别处用 npx agenthalo --dir ~/Applications。/Applications 不可写时会自动退到 ~/Applications，全程不需要 sudo。

也可以手动下载

先看「苹果菜单 → 关于本机」里的芯片一栏：

芯片显示 下载
Apple M1 / M2 / M3 / M4 AgentHalo-1.0.0-arm64.dmg
Intel AgentHalo-1.0.0-x64.dmg

.zip 是同一个应用的压缩包形式，和 .dmg 二选一。

手动下载的话，第一次打开会被系统拦下。 这一版还没有做 Apple 公证，浏览器下载的文件会被打上隔离属性，macOS 会提示无法验证开发者。应用本身的签名结构是完整的（codesign --verify --deep --strict 通过），手动允许一次即可：

  • macOS 15 及以上：拖进「应用程序」双击，出现提示后点「完成」，再打开「系统设置 → 隐私与安全性」，滑到底部点「仍要打开」。
  • macOS 14 及以下：在「应用程序」里右键点它，选「打开」，弹窗里再点一次「打开」。

用 npx agenthalo 不会遇到这一步。隔离属性是下载文件的那个程序打上去的，浏览器打，curl 和 Node 不打，两种方式拿到的是同一个应用。

打开之后

AgentHalo 没有 Dock 图标，它常驻在菜单栏。在「设置 → 连接应用」里给你实际用的 AI 工具装上 hook，桌宠才能收到它们的状态。网页版 AI 需要额外装一个浏览器扩展，在同一页里可以加载。

校验和

fb24710be73d34f3abc4cb6376b062c2f0408efcfbaa130a1a383562ac548ab0  AgentHalo-1.0.0-arm64.zip
5e245d092bc65744e660bf89acbe4dd7a9cbe25b5f85510950641e1c7dde74b1  AgentHalo-1.0.0-x64.zip
5d27b740aa888fc41f4ff8f12e54d6d6cc1681cb69a2f20dc9a36fee5ed7b7e7  AgentHalo-1.0.0-arm64.dmg
f8dfe8eca8465a79f2c846dc0b9bcdb214de8655b9b03bafc8d26adb9d5f16b3  AgentHalo-1.0.0-x64.dmg

已知限制

  • 未做 Apple 公证，手动下载时首次打开需要按上面的步骤允许一次。
  • 没有自动更新，新版本需要重新跑一次 npx agenthalo。
  • 浏览器扩展正在 Chrome 应用商店审核中，上架前需要手动加载已解压扩展。
  • 本次只提供 macOS 包。

许可证

AGPL-3.0-only。AgentHalo 基于 Clawd on Desk 开发，上游版权与许可证均已保留。

Assets 6
Loading