Agent Status Monitor

检查本地开发 Agent 的运行和活动状态，显示工作中、等待中、闲置或未运行及会话数量详情。

检查本地开发工具 Agent 的运行状态和活动状态。

---

触发条件

核心意图：快速了解本地运行的 AI 开发工具（Agent）是否在运行、是否在工作、是否有会话活动。

典型场景：

• 同时运行多个 Agent（Claude Code、OpenCode、OpenClaw），想确认各自状态
• 不确定某个 Agent 是否还在工作，还是已经卡住/闲置
• 想查看哪个 Agent 正在活跃使用，哪个只是后台运行
• 定期检查多个 Agent 的健康状态

触发示例：

• "检查 agent 状态"
• "Claude Code 还在工作吗"
• "看看有哪些 agent 在运行"
• "opencode 是不是闲置了"
• "运行 agents_monitor"

---

具体成果

一句话目标：运行 agents_monitor 命令，输出所有本地 Agent 的运行状态（运行中/工作中/闲置/未运行）和会话数量。

预期输出：

● Claude Code: 🔥 工作中 (2 分钟内有更新) · 13 个会话
● OpenClaw: 🔥 工作中 (2 分钟内有更新) · 1 个会话
● OpenCode: 💤 闲置 (未使用) · 1 个会话
○ Cursor IDE: 未运行

状态说明：

状态	含义
🔥 工作中	2 分钟内有会话文件更新
⏳ 等待中	10 分钟内有更新（可能在思考/等待 API）
💤 闲置	超过 10 分钟无更新，或未使用
○ 未运行	进程不存在

---

步骤逻辑

执行步骤

1. 运行检测脚本

   ~/.openclaw/workspace/skills/agent-status-monitor/scripts/check-agents.sh
   

2. 进程检测 - 对每个 Agent 执行：

   • ps aux | grep <agent> 检查进程是否存在
   • 排除系统误报进程（如 CursorUIViewService）

3. 活动状态判断 - 检查会话目录文件修改时间：

   • 2 分钟内有更新 → 🔥 工作中
   • 10 分钟内有更新 → ⏳ 等待中
   • 超过 10 分钟无更新 → 💤 闲置
   • 只有 1 个文件且超过 5 分钟 → 💤 未使用（初始配置）

4. 输出报告 - 包含：

   • 状态图标 + 文字说明
   • 会话文件数量
   • 详细配置信息（版本、配置路径等）

各 Agent 会话目录

Agent	会话目录
Claude Code	~/.claude/projects/
OpenClaw	~/.openclaw/agents/
OpenCode	~/.local/state/opencode/
Cursor IDE	进程检测（无统一会话目录）

约束

• 只检测本地运行的 Agent，不涉及云端/远程服务
• 基于文件系统修改时间，不依赖 Agent API
• 仅读取公开目录，不访问私有数据

---

正反样例

✅ 正例

输入：

检查 agent 状态

输出：

========================================
   Agent Status Monitor
========================================

--- 进程状态 ---
● Claude Code: 🔥 工作中 (2 分钟内有更新) · 13 个会话
● OpenClaw: 🔥 工作中 (2 分钟内有更新) · 1 个会话
● OpenCode: 💤 闲置 (未使用) · 1 个会话
○ Cursor IDE: 未运行

--- OpenCode 详情 ---
版本：1.2.15
  └─ 配置：~/.config/opencode/opencode.json
  └─ 会话日志：1 个文件

--- OpenClaw 状态 ---
[OpenClaw status 输出...]

输入：

Claude Code 还在工作吗

输出：

Claude Code: 🔥 工作中 (2 分钟内有更新) · 13 个会话

❌ 反例

输入：

检查 agent 状态

错误输出：

Claude Code: 运行中
OpenCode: 运行中

❌ 问题：没有显示活动状态（工作中/闲置），信息不完整

错误输出：

CPU 使用率：Claude Code 3.7%, OpenCode 0.3%

❌ 问题：CPU 使用率不可靠，Agent 等待 API 时 CPU 低但仍在工作中

错误输出：

Claude Code 进程 ID: 12345, 12346, 12347

❌ 问题：用户不关心进程 ID，关心的是"是否在工作"

---

明确限制

不做什么

• ❌ 不监控云端 Agent - 只检测本地进程和文件
• ❌ 不统计 Token 使用量 - 各 Agent 日志格式不统一，暂不支持
• ❌ 不显示进程 ID/内存占用 - 用户关心活动状态，不是系统指标
• ❌ 不控制/停止 Agent - 只读检测，不执行任何修改操作
• ❌ 不涉及敏感话题 - 纯技术检测，无内容审查

异常处理

情况	处理方式
会话目录不存在	显示"未运行"或"未安装"
无法读取文件时间	降级为仅进程检测
脚本执行失败	输出错误信息 + 建议检查路径
没有安装任何 Agent	显示"未检测到任何 Agent"

兜底策略

如果脚本检测失败，返回：

⚠️ 无法获取详细状态，尝试手动检查：
ps aux | grep -E "(claude|opencode|openclaw)" | grep -v grep

已知限制

1. Cursor IDE - 没有统一会话目录，仅进程检测
2. 新 Agent 类型 - 需要手动添加检测逻辑
3. 跨用户检测 - 只能检测当前用户的 Agent
4. 容器/Docker - 不检测容器内运行的 Agent

---

相关资源

• scripts/check-agents.sh - 主检测脚本
• references/agent-commands.md - 各 Agent 命令参考

更新日志

• 基于会话文件修改时间判断活动状态（比 CPU 使用率更可靠）
• 支持 Claude Code、OpenCode、OpenClaw、Cursor IDE
• 提供 agents_monitor 命令别名