K-文化的一切——从回归到 K-美妆,发送到您的邮箱订阅邮件

METAL MEDIA

lucaGazzola/forgeo

33PythonMIT

一个按计划自动调用AI编程代理干活并直接提交代码的无人值守调度器

Forgeo是一个Python工具,用一个纯JSON文件维护待办任务清单(backlog),并定期让Claude Code、Codex或opencode等编程代理去处理下一个任务,处理结果直接提交到main分支。整个过程不用分支也不用PR,只有真正需要人来决定的时候才会打扰你。待办清单为空时,代理会转而对代码库做一次重构。

它做什么

  1. 所有状态都保存在纯文本文件里,包括配置文件forgeo.yaml、待办清单backlog.json、日志以及待决策文件BLOCKER.md,全部存放在.forgeo文件夹中,随时可以查看。
  2. 使用流程是:forgeo init生成配置,forgeo validate在不实际调用代理的情况下只读检查配置、git仓库和代理命令是否正常,forgeo start启动一个后台守护进程,每隔interval_minutes分钟跑一轮。
  3. 每一轮会挑选依赖任务都已COMPLETED的、最早创建的OPEN任务交给编程代理处理并提交结果;如果开启了重试策略,网络抖动或测试偶发失败这类临时故障会自动重试。
  4. 网页控制台(forgeo web)可以查看所有已注册实例的待办清单、运行历史和日志,共享主机上还可以用令牌进行保护。
  5. 基于文件的待办清单会在每次代理运行前和守护进程启动时自动生成备份(backlog.json.bak),一旦发现损坏就会自动恢复,避免任务丢失。

为什么重要

它让开发者不必逐个手动给AI编程代理下达指令,而是让代理持续按队列自动处理任务,这对想减少人工盯梢、自动化重复性编码工作的开发者很有意义。直接提交到main、跳过分支和PR的做法特别适合追求快速迭代的个人项目或副业项目。

本仓库术语

  • backlog · 以纯文件保存的待处理任务列表
  • daemon · 在后台持续运行、按计划执行任务的程序
  • OAuth2 client-credentials · 一种常用于服务器间身份验证的标准认证方式
  • refactoring · 在不改变功能的前提下改善代码结构的工作

仓库简介(英文)

A scheduled, agent-driven software factory. Keep a plain JSON backlog; Forgeo runs your coding agent (Claude Code, Codex, opencode) on each task and commits to main. Refactors when idle. No branches, no PRs.

在 GitHub 打开

热门仓库

全部仓库 →

METAL MEDIA 最新报道