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 # 启动交互式设置
- 为新代理命名。
- 选择其运行时设置(后端模型、每日预算、工作文件夹)。
- 用纯文本描述任务 – 代理会编写
AGENT.md并开始运行。
需要 Node 22.19+ 和已登录的编码代理(Claude 开箱即用)。
核心概念
| 概念 | 含义 |
|---|---|
| 代理文件夹 | ~/overtime/agents/<name>/ 包含 AGENT.md(任务描述)、笔记、记忆文件和辅助脚本。 |
| 自我时间 | 每个代理决定何时唤醒:在固定时间、按 cron 式计划,或通过 监视 脚本在文件更改、日志事件等时触发。 |
| 预算与沙箱 | 每个代理强制执行每日 token/计算预算;文件系统权限使代理对受保护路径保持只读。 |
| 询问并继续 | 当需要决策时,代理发送带有选项和建议的消息。你可以在方便时回复;代理会自动恢复。 |
示例代理(预置用例)
- repo‑keeper – 监控 CI,自动修复损坏的构建,在合并前询问。
- on‑call – 监视日志/指标,诊断事件,回滚,编写事后分析。
- reviewer – 审查 PR,将大型审查拆分为辅助代理,报告发现。
- release – 创建发布,生成变更日志,运行金丝雀部署,在全面发布前询问。
- research – 定期阅读论文或文档,仅在出现值得注意的内容时总结。
- 旅行、找房、理财、学习、副项目 – 个人生活代理,自动化旅行规划、租房搜索、预算管理、日常练习和周末项目维护。
底层工作原理
- 基于文件夹的代理 – 所有状态都保存在纯文本文件中,你可以检查或编辑。
- ACP 后端适配器 – Overtime 可与任何实现代理客户端协议(Claude、Codex、Gemini、OpenCode 等)的 LLM 编码服务通信。
- 后台守护进程 – 关闭 CLI 后,一个轻量级后台进程保持代理存活,仅在需要时唤醒它们,因此空闲时不会产生成本。
- 监视脚本 – 用户提供的小型脚本可以立即触发代理(例如,新的日志行、价格下降、新的 PR)。
- 预算执行 – 守护进程跟踪每个代理的 token 使用情况,并在达到每日限制后停止进一步调用。
安装与要求
- Node ≥ 22.19
- npm(全局安装
@ukanwat/overtime) - 至少一个已登录的受支持编码代理(Claude 开箱即用;Codex 和 Gemini 需要其 ACP 适配器)。
当前状态
- 早期原型 – Claude 后端测试最多;Codex 和 Gemini 适配器存在但验证较少。
- 计划功能:移动端回复、安静时段整理、晨间站会摘要、代理共享、24/7 监视的服务器端部署。
许可证
MIT – 免费用于个人和商业用途。
简而言之:Overtime 为你提供一个持久化、预算控制的“助手”,可以持续运行基于 LLM 的编码代理,仅在需要人工决策时打扰你。它面向那些希望 AI 助手在专注于更高层次工作时保持运转的开发者。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト