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 도구입니다. 에이전트는 세션을 열어두지 않아도 작업을 계속 수행하는 자율 어시스턴트입니다. 한 번 자연어로 간단히 지시하면, 에이전트는:

  • 작업을 계획하고,
  • Agent Client Protocol (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 助手在专注于更高层次工作时保持运转的开发者。

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트