看见 AI 在做什么,需要你时及时提醒。
AgentCue 是一款本地优先的 AI 编码任务监控桌面应用。将多个工具的任务集中到看板和动画办公室,在任务开始、需要确认、任务完成时按你的规则提醒,减少反复切换窗口。
从 Releases 下载对应安装包。当前正式版为 v1.0.1,基于 Rust + Tauri 2。
| 系统 | 安装包 |
|---|---|
| macOS · Apple 芯片 | AgentCue_1.0.1_aarch64.dmg |
| macOS · Intel | AgentCue_1.0.1_x64.dmg |
| Windows · x64 | AgentCue_1.0.1_x64-setup.exe |
| Linux · x64 | AgentCue_1.0.1_amd64.deb 或 AgentCue_1.0.1_amd64.AppImage |
macOS 将应用拖入「应用程序」后启动;Windows 运行安装程序;Linux 给 AppImage 添加执行权限后运行。安装版自带运行环境,无需安装 Node.js、pnpm 或拉取源码。
本正式版尚无正式代码签名和 macOS 公证,macOS 可能提示开发者未验证。四个平台均经过 CI 构建与包内自检;完整系统交互和音频设备的人工验收以 macOS 为主。下载附件可使用同一 Release 中的 SHA256SUMS.txt 校验。
- 任务看板:按待介入、执行中、需要检查、已结束分列,搜索、筛选并查看时间线。
- 动画办公室:工具化身员工,工位展示真实任务状态;重要消息主动出现,其他信息悬浮查看。
- 语音与通知:系统音色、本地 Kokoro / ZipVoice,以及需要显式启用的云语音;支持试听、音量、免打扰和全局静音。
- 独立播报接入:按工具提供 Hooks 和 MCP 配置,复制、粘贴并验证,无需额外启动桥接服务。
- 接入诊断与引导:按工具查看采集开关、事件来源、最近关键事件与扫描问题;开始新一轮验证后,只核验之后真实收到的关键事件。可展开自动播报策略,分别排查事件接收和语音规则。
- 本地数据:任务记录和设置保存在本机;采集可关闭,工具可忽略。云语音关闭时不会上传播报文本。
| 工具 | 任务事件来源 | 需要确认提醒 |
|---|---|---|
| CodeX 桌面客户端 / CLI | 本机公开 rollout 文件,按任务轮次采集 | 审批未落盘,不能可靠推断 |
| Claude Code | 官方 Hooks;兼容 JSONL 采集 | permission_prompt 通知 |
| Cursor 自带 Agent | 官方 Hooks | AskQuestion 调用 |
| Cursor 中的 Cline | 扩展安装识别 + 官方 Hooks;历史索引另列 | 以实际提供的 Hook 事件为准 |
| Cursor 中的 CodeBuddy | 扩展安装识别 + 官方 Hooks | 以实际提供的 Hook 事件为准 |
识别已安装、MCP 连通与任务播报接入是不同能力。 仅识别安装或配置 MCP 不会凭空产生任务事件;请按工具完成 Hooks 配置。历史快照不计作正在执行的任务,缺少状态时显示未知。
- 打开「工具与扩展」,核对已识别工具;在设置中开启需要的本地来源读取。
- 打开「播报接入」,展开对应工具的 Hooks 或 MCP,按步骤合并配置,保留原有条目。
- 重新加载对应工具并发起新任务,核对「最近事件」和任务看板。
- 在设置中选择后端与音色,保存后试听。本地模型需要你主动下载,不会随首次启动自动下载。
- 如需任务开始、完成也发声,将播报范围设为包含里程碑;默认仅待确认发声,其余里程碑保留通知。
全局静音优先于免打扰例外。历史补采和重复事件不会重复自动播报。Windows 提供 Cursor PowerShell、Cline .ps1 和 Claude Code / CodeBuddy Git Bash 配置;需要工具版本支持相应 Hooks 执行方式,具体步骤见「播报接入」。MCP 与文件采集能力单独判断。
- 播报接入:按工具查看采集条件、最近开始/待确认/完成事件,并从当前时刻开始验证;不会把历史事件计为新验证。
- 设置 → 应用与数据:登录启动、隐藏启动、关窗继续监控;数据占用、本机备份、下次启动恢复、过期终态清理和脱敏诊断导出。
- 语音:查看当前播放、停止、手动重试失败播报及自定义读音。模型可查看来源、校验 SHA-256、删除、重新下载或从本机解压目录导入。
- 看板与办公室:日期/排序筛选、归档已加载终态任务、记住筛选和动效偏好;任务详情在已获得路径时提供打开原工具或项目目录。
备份包含任务数据库和主设置,不含模型、参考录音、API Key、系统启动配置和独立读音词典;恢复保留当前云语音配置。备份含任务信息,只存在本机,请自行保管。清理默认关闭,确认后才启用;保留进行中、待确认、失败和超时任务。详见本机管理说明。
v1.0.1 使用 Rust + Tauri 2 和系统 WebView,不再把 Chromium 与 Node.js 打进安装包;各平台的实际下载大小见 Release 附件。安装包仍包含本地 TTS 推理运行库,Kokoro / ZipVoice 模型由用户在应用中主动下载,不随包分发。v0.2.0 的 Electron 安装包继续保留在旧版 Releases 中。
全部插画原稿、历史版本和设计说明仍保留在仓库中,只是不进入应用包。编译源码、中间文件和未使用的插画版本也不会打进安装包。
完全退出旧版,再用新版替换应用。「设置 → 应用与数据」可手动检查 GitHub 最新正式版并打开下载;没有后台检查或自动安装。
AgentCue 原名 AI Workflow Monitor。v1.0.0 初期修订会在首次启动时将旧目录迁移到新的平台路径,保留已有设置、历史记录、模型和握手文件:
| 系统 | 默认数据目录 |
|---|---|
| macOS | ~/Library/Application Support/AgentCue/ |
| Windows | %LOCALAPPDATA%/AgentCue/ |
| Linux | $XDG_DATA_HOME/agentcue/,未设置时使用 ~/.local/share/agentcue/ |
Linux 设置单独保存在 $XDG_CONFIG_HOME/agentcue/,未设置时使用 ~/.config/agentcue/。同盘迁移不重复复制大型模型;跨盘迁移会保留旧目录作为副本,不覆盖新版目录已有内容。
从开发版迁到安装版、从旧名称更名或移动安装位置后,到「播报接入」更新原 Hooks / MCP 条目的启动路径一次;同一安装路径下更新通常不需要重配。MCP Server 键 ai-workflow-monitor、CLI awm-mcp 和包 scope @awm/* 保持兼容,避免重复添加。
需要 Node.js 22 和项目指定的 pnpm 10.6.0。
git clone https://github.com/ideshun/AgentCue.git
cd AgentCue
corepack enable
pnpm install --frozen-lockfile
sh scripts/l1-verify.sh
pnpm devbetter-sqlite3 需匹配 Electron ABI。项目测试脚本会探测可用运行时,不会为跑测试重编译共享模块或读取生产数据库。pnpm dev 会先对齐桌面原生依赖;跨平台打包应在对应系统与架构运行。
1.0 正式版使用 Rust + Tauri 2,复用 TypeScript / CSS 页面及办公室。安装 rustup 后,运行 pnpm rust:verify 验证核心,运行 pnpm tauri:bundle 构建当前平台的安装包。构建、隔离运行及 Hooks / MCP 升级说明见 原生版交付手册;数据目录与旧版迁移规则见 ADR-22。
在 Issues 提交问题时,提供系统、CPU 架构、应用版本、复现步骤和脱敏错误。请勿提交 settings.json、runtime.json、API Key、数据库或完整会话内容。