Repository navigation
Releases
Releases · NePixe1/AgentHalo
Agent Halo v1.2.0:新增代理监控与界面优化 / New agent monitoring and UI refinements
Agent Halo v1.2.0:新增代理监控与界面优化 / New agent monitoring and UI refinements
中文
新增监控
- Windows 和 macOS 新增 OpenCode:通过内嵌插件和本地原子快照识别思考、工具执行、授权等待、完成和故障,展示会话、模型、输入输出及上下文占用。首次安装插件后需重启已经打开的 OpenCode。
- Windows 和 macOS 新增 WorkBuddy:只读本地活会话、数据库和响应日志,不安装 hook、不修改 WorkBuddy 配置,展示任务状态、模型、最近一次响应输入输出和上下文。
- 保留已有监控对象勾选记录;OpenCode 和 WorkBuddy 默认关闭,可在菜单中启用。
界面与可靠性
- Windows 优化状态文字和代理切换过渡,减少白闪、透明度突变和位移;将 Codex 扫描与界面读取解耦,减少切换卡顿。
- macOS 更新详情面板的浅色底板、留白、代理切换栏和上下文百分比样式;未选中的代理图标统一灰显,选中后恢复原色。
- 两端统一任务区左对齐和分割线,模型、输入和输出使用紧凑标签,输入为蓝色、输出为青绿色;无会话时保持相同的内容起点。
- macOS 的 Pi、OpenCode 和 WorkBuddy 详情优先显示完整工作目录;长模型名优先截断,为输入输出 token 数字保留空间。
- Windows 修复部分 Pi 和 OpenCode 运行中进程被误判为退出的问题,校验进程创建时间以避免 PID 复用,并改善恢复会话与长任务检测。
- macOS 改善监控快照重试和活任务保留,修复 Claude statusline 配置迁移,并确保交互自检必须输出完成标记。
- 内嵌 OpenCode 插件及 WorkBuddy 图标,安装包不依赖外置开发资源或
sqlite3.exe。
安装与说明
- Windows 10/11:完整解压
AgentHalo-Windows-v1.2.0.zip后运行AgentHalo.exe,需要 .NET Framework 4.8。未签名构建可能触发 SmartScreen。 - macOS 13 及以上:下载
AgentHalo-macOS-1.2.0.dmg,将应用拖入 Applications。此附件为 Apple Silicon 构建,采用临时签名,首次打开可能需要在“系统设置 → 隐私与安全性”中允许。 SHA256.txt提供发布附件的校验值;Windows 压缩包内也包含原始 EXE 的校验值。- WorkBuddy 本地存储并非稳定公共 API,暂不保证远程或云端任务检测。输入输出展示最近一次有效响应用量,不代表累计账单;缺少数据时不伪造数字。
- 生命周期和会话内容保留在本地,不上传会话内容。
English
New monitoring
- Added OpenCode on Windows and macOS. A bundled plugin and local atomic snapshots track thinking, tool execution, approval waits, completion, and failures, with session, model, input/output tokens, and context usage. Restart any already running OpenCode instance after the plugin is first installed.
- Added WorkBuddy on Windows and macOS. Read-only monitoring of local live sessions, the database, and response logs provides task state, model, latest-response token counts, and context usage, without installing hooks or changing WorkBuddy settings.
- Existing enabled-agent selections are preserved. OpenCode and WorkBuddy are off by default and can be enabled from the menu.
UI and reliability
- Windows refines status text and agent-switch transitions to reduce flashes, abrupt opacity changes, and movement. Codex scanning no longer blocks UI reads during switching.
- macOS refreshes the details panel with a light surface, improved spacing, agent switcher, and context percentage. All inactive agent icons are grayscale; selecting an agent restores its original colors.
- Both platforms align the session area and divider, with compact model, input, and output chips: blue for input and teal for output. Empty sessions retain the same content alignment.
- macOS prefers the full working directory in Pi, OpenCode, and WorkBuddy details. Long model names truncate first to preserve space for input/output token counts.
- Windows fixes false process-exit detection for some Pi and OpenCode sessions, checks process creation times against PID reuse, and improves resumed-session selection and long-running task detection.
- macOS improves snapshot retries and live-task retention, fixes Claude statusline configuration migration, and requires an explicit completion marker from interaction self-checks.
- The OpenCode plugin and WorkBuddy icon are bundled; installed apps do not depend on development resources or
sqlite3.exe.
Installation and notes
- Windows 10/11: Fully extract
AgentHalo-Windows-v1.2.0.zip, then runAgentHalo.exe. Requires .NET Framework 4.8. Unsigned builds may trigger SmartScreen. - macOS 13 or later: Download
AgentHalo-macOS-1.2.0.dmgand drag the app into Applications. This asset is an Apple Silicon build with an ad-hoc signature; the first launch may require approval in System Settings → Privacy & Security. SHA256.txtcontains checksums for the release assets. The Windows archive also includes the original EXE checksum.- WorkBuddy's local storage is not a stable public API; remote or cloud task detection is not guaranteed. Input/output counts reflect the latest valid response rather than cumulative billing. Missing values are never fabricated.
- Lifecycle and session content remain local; session content is not uploaded.
Agent Halo v1.1.1
Agent Halo 1.1.1
此版本包含最新 macOS 修复:
- 紧凑显示自定义 API Key 会话的 Token 指标。
- 优化详情面板的毛玻璃材质与文本截断,维持低噪、易扫读的界面。
- 修复已安装 DMG 在非构建机器上启动时的 SwiftPM 资源回退问题。
安装
- macOS:打开
AgentHalo-macOS-1.1.1.dmg,将 Agent Halo 拖入“应用程序”。首次启动若被 macOS 拦截,请前往“系统设置 → 隐私与安全性”,点按“仍要打开”。 - Windows:此发布继续提供
v1.1.0的AgentHalo.exe及AgentHalo-Windows-v1.1.0.zip,以保持与上一版 Windows 构建一致。Windows 需要 .NET Framework 4.8。
说明
- macOS DMG 使用 ad-hoc 签名,未经 Apple 公证,首次启动需要手动批准。
- Windows 个人构建可能触发 SmartScreen;ZIP 包含 SHA-256 校验值。
Agent Halo v1.1.0
Agent Halo 1.1.0
Agent Halo 1.1.0 是 1.0 正式版后的首个功能更新,继续保持 Windows 与
macOS 原生客户端、共享行为规范和本地优先的监控方式。
主要变化
- Windows 与 macOS 新增 Grok Build 监控,包括生命周期、上下文和官方额度。
- macOS 可选支持 Antigravity,覆盖状态、权限等待和 Gemini 额度窗口。
- Windows 与 macOS 均可配置要监控的 Agent,减少无关轮询并记住选择。
- 支持双击光环激活当前 Agent 所在的桌面应用或终端宿主;单击仍不抢焦点。
- 更新 Agent Halo 应用图标、Agent 官方图标、README 横幅和中英文文档。
- 统一本地运行数据目录,迁移 hooks、日志、缓存和状态文件,并清理旧路径。
- 改进 Codex、Claude Code、Grok 和 Pi 的上下文、额度、会话标题及完成态判断。
- 优化 macOS 轮询与绘制开销,并修复多项菜单、设置和深色桌面可读性问题。
本次 Windows 修复
- 修复筛选监控 Agent 后,切换滑块仍停留在旧槽位的问题。
- 修复 Pi 恢复会话时被旧的完成记录覆盖,导致当前待命状态、模型、Token 或
上下文显示不正确的问题。
本次 macOS 修复
- 修复 DMG 在非构建机器上启动时,因 SwiftPM 资源回退路径被提前解析而直接
退出的问题。此前已下载 macOS DMG 的用户请重新下载同名文件。
安装
- Windows:完整解压
AgentHalo-Windows-v1.1.0.zip,运行AgentHalo.exe。 - macOS:打开
AgentHalo-macOS-1.1.0.dmg,将 Agent Halo 拖入“应用程序”。
首次启动若被 macOS 拦截,请前往“系统设置 → 隐私与安全性”,点按
“仍要打开”并确认。
说明
- 应用仍为本地优先,生命周期和会话内容不会上传到 Agent Halo 服务。
- Windows 需要 .NET Framework 4.8;macOS 需要 macOS 13 或更高版本。
- macOS DMG 使用 ad-hoc 签名且未经 Apple 公证,首次启动需要手动批准。
- Windows 个人构建可能触发 SmartScreen;ZIP 包含 SHA-256 校验值。
Agent Halo 1.0.0
Agent Halo 1.0.0
Agent Halo 1.0.0 is the first stable release of the cross-platform desktop
status halo for Codex and Claude Code.
Highlights
- Adds native Codex and Claude Code usage monitoring on macOS, including
account-aware detail views and retained session context. - Adds real-time Codex runtime monitoring and usage refresh improvements on
Windows. - Supports custom Codex API configurations without exposing sensitive
connection details in the UI. - Improves the macOS details panel: session titles, current-turn token usage,
quota presentation, localization, and stable layout across agent switches. - Reduces macOS monitoring CPU work while preserving the rendered halo output.
Installation
- macOS: open
AgentHalo-macOS-1.0.0.dmg, then drag Agent Halo to
Applications. - Windows: download
AgentHalo.exeand run it directly; useSHA256.txtto verify the download.
Notes
- The application is local-first. OAuth usage refreshes reuse the existing
Codex or Claude Code sign-in; no API key is required for official accounts. - Windows requires .NET Framework 4.8. macOS requires macOS 13 or later.
Agent Halo v0.13.0
Agent Halo v0.13.0 focuses on the Windows interface refresh and repository cleanup.
Highlights
- Redesigned the compact hover panel with quota reset times and context usage.
- Added a custom Windows 11-style context menu shared by the halo and tray icon.
- Removed the 150% size preset; available sizes are now 75%, 100%, and 125%.
- Improved Windows typography, panel materials, shadows, and execution-blue saturation.
- Reorganized the repository into src, scripts, and docs while preserving the shared Windows/macOS contract.
- Kept generated C# and Swift parameters synchronized through the shared specification.
Download
- Windows: AgentHalo-Windows-v0.13.0.zip
- macOS source is included in the repository; a macOS installer is not attached to this release.
SHA-256: C6DBDAF7BAA12FD732F1D4C505179B2FB325F5C20DA1E7E1C0880285D42632CF
Agent Halo v0.12.0
Agent Halo v0.12.0 introduces a generated behavior contract shared by the native Windows and macOS clients.
Highlights
- Added the V2 cross-platform behavior specification.
- Generates native C# and Swift state parameters from one source of truth.
- Aligns state semantics, colors, breathing, gap motion, failure classification, and usage-limit parsing.
- Added Windows, macOS, and shared-contract CI checks.
- Preserves the existing Windows visual design and animation behavior.
Downloads
- AgentHalo-Windows-v0.12.0.zip: Windows 10/11 portable build.
- SHA-256: $zipHash
The macOS source and CI checks are included in this release. A packaged macOS download will be added separately after native packaging and signing are completed.
Agent Halo v0.10.2
Agent Halo v0.10.2 pre-release.
Highlights:
- Added off-screen recovery to move the halo back to the primary display.
- Improved state transitions, breathing animation, attention pulses, and fault lifecycle.
- Updated bilingual documentation and local privacy details.
更新重点:
- 新增“脱离卡死”,可将光环移回主屏右上角。
- 优化状态切换、呼吸动画、授权双脉冲和故障生命周期。
- 更新中英文 README 与本地隐私说明。