v0.3.0 – Codex native hooks

v0.3.0 – Codex native hooks

Highlights

• Reworked Codex CLI integration from JSONL session polling to native ~/.codex/hooks.json command hooks.
• Added Codex state sync for session, prompt, tool-use, stop, and compact events.
• Added an opt-in experimental Codex Permission Review toggle for single-use Allow / Deny permission bubbles.
• Added Codex terminal focus metadata from the hook process tree, including real Codex agent PID tracking.

Improvements

• Codex hook installation is idempotent and preserves user hooks.
• Codex permission hooks are off by default; enabling/disabling the experiment only touches PermissionRequest.
• Permission requests fail open when Clawd is unavailable, DND is enabled, bubbles are hidden, or the request is undecided.
• Hardened Codex permission delivery against stale runtime ports by probing candidates before long /permission POSTs.
• CI now runs the full hook-side test suite.

Migration notes

• The old Codex JSONL monitor and remote monitor scripts were removed.
• Codex may require running /hooks inside Codex once to review/trust newly registered command hooks.
• If Codex hooks are disabled in Codex config, state sync will remain inactive until hooks are enabled there.

Validation

• swift test
• cd hooks && node test/index.js

Full Changelog: v0.2.4...v0.3.0

v0.2.4

主要改动

安全与稳定性

• Focus 加固 (#9)：会话激活终端前校验 agent 进程身份与父子链（bundle/exe path/launchDate），防止 PID 复用导致激活非预期 App；同时移除 ancestry bypass，回归严格的 bundle 白名单（Ghostty 已加入），并切换到 macOS 14+ 的新 activate API。
• 文档完善 (#9)：补齐 Core / SVG / UI / Bubble / Mini-mode 等子系统的内联注释与不变量说明，方便后续贡献者快速上手。

发布流程

• Sparkle appcast 改由 GitHub Pages 托管 (#10)：feed 地址切换至 https://blueocean223.github.io/hey-clawd/appcast.xml；release workflow 不再写 main，main 分支可放心开启 branch protection / ruleset。

升级提示

本版改动了 Sparkle feed URL，旧版本（≤ 0.2.3）的客户端不会自动收到本次更新通知。请手动下载下方资源安装一次；从 v0.2.4 起，后续版本会自动经由 GitHub Pages 推送更新。

下载

• hey-clawd-0.2.4.dmg — 推荐，附带 Applications 拖拽快捷方式
• hey-clawd-0.2.4.zip — Sparkle 自动更新通道使用，可手动解压安装

Full Changelog

v0.2.3...v0.2.4

v0.2.3

更新内容

• 简化 Claude Code 权限气泡操作，减少重复选项，让允许/拒绝/本轮记住的选择更直接。
• 权限请求如果已经在终端侧处理，App 会用工具名、工具输入哈希和 tool_use_id 精准匹配并自动收起对应气泡，避免旧气泡残留。
• 增加 Swift 与 Node 共用的权限匹配键校验，覆盖批量工具事件、超时清理、权限建议归一化和气泡内容展示边界。

验证

• swift test
• cd hooks && node test/index.js
• Release workflow 25275215512 passed

Full Changelog: v0.2.2...v0.2.3

v0.2.2

Full Changelog: v0.2.1...v0.2.2

v0.2.1

What's Changed

• fix: harden Sparkle update signing by @BlueOcean223 in #6

Full Changelog: v0.2.0...v0.2.1

v0.2.0

Highlights

• Added Pi agent monitoring integration
• Improved Pi extension delivery reliability
• Cleaned up Pi registration node detection
• Updated installation and README guidance

What's Changed

• fix: resolve hooks from workspace in xcode builds by @BlueOcean223 in #1
• chore: move SVG animation spec into docs by @BlueOcean223 in #2
• ci: add CI and release workflow guards by @BlueOcean223 in #3
• fix: clean up Pi registration node detection by @BlueOcean223 in #4
• Docs/readme tweaks by @BlueOcean223 in #5

New Contributors

• @BlueOcean223 made their first contribution in #1

Full Changelog: v0.1.0...v0.2.0

v0.1.0

Full Changelog: https://github.com/BlueOcean223/hey-clawd/commits/v0.1.0