ukanwat/overtime

Give a coding agent a brief, not a chat, and it works on its own across sessions. Includes an example run: an open-world city built in a real game engine with no human help. In early development.

Overtime – 持久化编码代理

它是什么

Overtime 是一个 Node‑JS 工具,可让你创建 代理 – 自主助手,无需保持会话打开即可持续处理任务。你只需用自然语言简要说明一次,它就会:

  • 规划工作,
  • 通过代理客户端协议(ACP)运行代码生成模型(Claude、Codex、Gemini 等),
  • 将自身的笔记、记忆和脚本存储在专用文件夹中,
  • 按计划或当监视脚本检测到触发器时自行唤醒,并且
  • 仅在需要你输入决策时才通知你。

它本质上是现有基于 LLM 的编码代理的编排层,为它们提供持久化、预算感知的运行时。


快速开始

npm install -g @ukanwat/overtime   # 全局安装 CLI
overtime                           # 启动交互式设置
  1. 为新代理命名。
  2. 选择其运行时设置(后端模型、每日预算、工作文件夹)。
  3. 用纯文本描述任务 – 代理会编写 AGENT.md 并开始运行。

需要 Node 22.19+ 和已登录的编码代理(Claude 开箱即用)。


核心概念

概念 含义
代理文件夹 ~/overtime/agents/<name>/ 包含 AGENT.md(任务描述)、笔记、记忆文件和辅助脚本。
自我时间 每个代理决定何时唤醒:在固定时间、按 cron 式计划,或通过 监视 脚本在文件更改、日志事件等时触发。
预算与沙箱 每个代理强制执行每日 token/计算预算;文件系统权限使代理对受保护路径保持只读。
询问并继续 当需要决策时,代理发送带有选项和建议的消息。你可以在方便时回复;代理会自动恢复。

示例代理(预置用例)

  • repo‑keeper – 监控 CI,自动修复损坏的构建,在合并前询问。
  • on‑call – 监视日志/指标,诊断事件,回滚,编写事后分析。
  • reviewer – 审查 PR,将大型审查拆分为辅助代理,报告发现。
  • release – 创建发布,生成变更日志,运行金丝雀部署,在全面发布前询问。
  • research – 定期阅读论文或文档,仅在出现值得注意的内容时总结。
  • 旅行、找房、理财、学习、副项目 – 个人生活代理,自动化旅行规划、租房搜索、预算管理、日常练习和周末项目维护。

底层工作原理

  1. 基于文件夹的代理 – 所有状态都保存在纯文本文件中,你可以检查或编辑。
  2. ACP 后端适配器 – Overtime 可与任何实现代理客户端协议(Claude、Codex、Gemini、OpenCode 等)的 LLM 编码服务通信。
  3. 后台守护进程 – 关闭 CLI 后,一个轻量级后台进程保持代理存活,仅在需要时唤醒它们,因此空闲时不会产生成本。
  4. 监视脚本 – 用户提供的小型脚本可以立即触发代理(例如,新日志行、价格下降、新 PR)。
  5. 预算执行 – 守护进程跟踪每个代理的 token 使用情况,并在达到每日限制后停止进一步调用。

安装与要求

  • Node ≥ 22.19
  • npm(全局安装 @ukanwat/overtime)
  • 至少一个已登录的受支持编码代理(Claude 开箱即用;Codex 和 Gemini 需要其 ACP 适配器)。

当前状态

  • 早期原型 – Claude 后端测试最多;Codex 和 Gemini 适配器存在但验证较少。
  • 计划功能:移动端回复、静默时间整理、晨间站会摘要、代理共享、24/7 监视的服务器端部署。

许可证

MIT – 免费用于个人和商业用途。


简而言之:Overtime 为你提供一个持久化、预算控制的“助手”,可以持续运行基于 LLM 的编码代理,仅在需要人工决策时打扰你。它面向那些希望 AI 助手在专注于更高层次工作时保持运转的开发者。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目