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 # 启动交互式设置
- 为新代理命名。
- 选择其运行时设置(后端模型、每日预算、工作文件夹)。
- 用纯文本描述任务 – 代理会编写
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 助手在专注于更高层次工作时保持运转的开发者。
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트