AI Pulse

AI Pulse 是一款面向 macOS 的环境感知灯光指示器，为 AI 编程 agent 提供可视化的状态反馈。它以一条细长的虚拟 LED 灯带浮于 Dock 旁边，通过 8 个灯珠的颜色和闪烁节奏，直观显示当前是否有 AI agent 正在工作、等待人工介入、任务已完成、或是遇到错误。

这款工具的灵感来源于 SidePulse 硬件设备，但以纯软件方式实现，无需任何私有 API 或辅助权限，不注入 Dock 进程，也不申请屏幕录制或辅助访问权限，完全依托 macOS 公开的屏幕几何 API（NSScreen.frame）定位面板，做到了真正的零侵扰。

AI Pulse 通过本地 HTTP 服务（127.0.0.1:7455）与各 AI 编程工具集成。开发者调用随附的 aipulse CLI，即可向服务注册或更新 agent 状态。例如：aipulse agent upsert --id "claude-code:$PWD:$SESSION_ID" --name "Claude Code" --provider anthropic --state working --message "Implementing feature"。目前支持 Claude Code、Cursor、Windsurf 等主流 AI 编程工具的状态上报。

该工具由 Swift 6 / Xcode 16 构建，核心模块 AIPulseKit 完全独立于 AppKit，可单元测试。适用于 macOS 14 及以上。GitHub 下载最新 release，解压后将 AI Pulse.app 拖入 /Applications 即可运行。

解决的问题：当开发者同时与多个 AI agent 交互时，很难直观判断哪些任务还在跑、哪些在等人审批、哪些已完成。AI Pulse 用物理世界的灯光概念，把这个数字空间的状态一目了然地呈现出来。