Agent Ops#

Agent session 运维工具集。监控、恢复、保护运行中的 agent session。

When to Use#

• tmux 中的 agent 遇到 API 限速后挂死 → Rate Limit 恢复
• Session 静默死亡，需要回收其知识 → Stale Session Daemon
• Bash 命令可能造成不可逆破坏 → Checkpoint + Rollback
• Context 快用完，需要预算管理 → Token Budget / Context 估算
• 模型反复失败需要切换 → Auto Model Fallback

When NOT to Use#

• 安装 Stop/PreToolUse hook → 用 agent-hooks
• 设计 agent 架构 → 用 harness-design-patterns

---

工具概览#

工具类型功能详情Rate Limit 恢复bash 脚本 / cron扫描 tmux pane 检测限速，自动发 Enter 恢复详情Context 估算bash 脚本读 transcript 尾部 4KB 提取 token 使用率详情Stale Session Daemondaemon / cronHeartbeat 检测 + 死 session 知识回收详情Checkpoint + Rollbackhook 脚本PreToolUse git stash + PostToolUseFailure 自动回滚详情Token Budgethook 脚本UserPromptSubmit 注入预算感知指令详情Auto Model Fallbackhook 脚本3 次连续失败后升级 Haiku→Sonnet→Opus详情

Scripts#

脚本用途scripts/context-usage.sh <transcript>从 transcript JSONL 尾部估算 context 使用率

Session State#

所有状态统一在 sessions/<session-id>/ 下。详见 session-state-layout.md。

条件判断规则#

• 如果只有 1-2 个 session 在跑 → Rate Limit 恢复手动即可，不需要 daemon
• 如果 session 预计 < 30 分钟 → 不需要 Stale Session Daemon
• 如果没有破坏性 Bash 命令 → 不需要 Checkpoint
• 如果不确定 context 够不够 → 先跑 context-usage.sh 检查再决定