lucaGazzola/forgeo

★ 33PythonMIT

AI 코딩 에이전트를 정해진 시간마다 자동으로 돌려 코드를 커밋시키는 무인 작업 관리자

Forgeo는 할 일 목록(백로그)을 JSON 파일로 관리하면서 Claude Code, Codex, opencode 같은 AI 코딩 에이전트를 주기적으로 실행시켜 작업을 처리하고 결과를 바로 main 브랜치에 커밋하는 파이썬 도구다. 브랜치나 PR 과정 없이 사람이 정말 결정을 내려야 할 때만 개입을 요청하고, 나머지는 알아서 진행된다. 할 일이 없으면 코드 리팩토링을 대신 수행한다.

무엇을 하는 레포인가

forgeo.yaml 설정과 .forgeo 폴더에 담긴 backlog.json(할 일 목록), 로그, 블로커 파일로 상태를 전부 평문 파일에 기록해 언제든 확인 가능하다.
forgeo init으로 초기 설정을 만들고, forgeo validate로 실제 실행 없이 설정·git 저장소·에이전트 명령을 사전 점검한 뒤, forgeo start로 백그라운드 데몬을 띄워 정해진 간격마다 한 사이클씩 작업을 처리한다.
한 사이클마다 의존 작업이 모두 끝난 가장 오래된 OPEN 상태 작업을 골라 코딩 에이전트를 실행하고 결과를 커밋하며, 네트워크 오류나 불안정한 테스트 같은 일시적 실패는 재시도 정책이 켜져 있으면 자동으로 다시 시도한다.
웹 대시보드(forgeo web)로 여러 저장소(인스턴스)의 백로그와 실행 기록, 로그를 한 화면에서 관리할 수 있고, 토큰 인증도 지원한다.
백로그 파일은 에이전트 실행 전과 데몬 시작 시마다 백업본(backlog.json.bak)을 남기고, 손상이 발견되면 자동 복구해 작업 목록이 유실되지 않도록 한다.

왜 중요한가

사람이 매번 프롬프트를 붙잡고 있지 않아도 AI 에이전트가 백로그 기반으로 코드를 계속 진행시킬 수 있어, 반복적인 개발 작업을 자동화하려는 개발자나 소규모 팀에게 실질적인 시간 절약 도구가 될 수 있다. 브랜치·PR 없이 바로 main에 커밋하는 방식이라 빠른 반복이 중요한 개인 프로젝트나 사이드 프로젝트에 특히 적합하다.

이 레포의 용어

백로그(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에서 보기

주목받는 레포

레포 전체 보기 →

lucaGazzola/forgeo

무엇을 하는 레포인가

왜 중요한가

이 레포의 용어

주목받는 레포

METAL MEDIA 최신 기사