lucaGazzola/forgeo
A scheduler that keeps running your AI coding agent on tasks and committing the results without human babysitting
Forgeo is a Python tool that keeps a plain JSON to-do list (backlog) and periodically runs a coding agent such as Claude Code, Codex, or opencode on the next task, committing the outcome straight to main. There are no branches or pull requests; a human is only pulled in when a genuine decision is needed. When the backlog is empty, the agent runs a refactoring pass on the codebase instead.
What it does
- All state — config (forgeo.yaml), the backlog (backlog.json), logs, and pending-decision files (BLOCKER.md) — lives in plain files you can inspect anytime, inside a .forgeo/ folder.
- Setup flow: forgeo init creates the config, forgeo validate does a read-only dry run checking the config, git repo, and agent command without invoking anything, then forgeo start launches a background daemon that runs one cycle every interval_minutes.
- Each cycle picks the oldest OPEN task whose dependencies are all COMPLETED, runs the coding agent on it, and commits the result; transient failures like a network blip or flaky test are retried automatically if the retry policy is enabled.
- A web dashboard (forgeo web) shows every registered instance's backlog, run history, and logs, and can be protected with a bearer token for shared hosts.
- The file-based backlog is snapshotted (rotating backlog.json.bak backups) before every agent run and on daemon startup, and restored automatically if corruption is detected.
Why it matters
It lets a developer keep an AI coding agent working through a task queue continuously instead of prompting it one task at a time, which matters for anyone trying to automate repetitive coding work with less manual oversight. Direct commits to main with no branch or PR step make it well suited for fast iteration on solo or side projects.
Terms in this repo
- backlog · a plain-file list of pending tasks
- daemon · a background process that keeps running and performs work on a schedule
- OAuth2 client-credentials · a standard authentication method used for server-to-server access
- refactoring · restructuring code to improve quality without changing its behavior
Repository description (English)
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.
Open on GitHubTrending repos
- vorssaint/vorssaint-utilsOne free menu bar app replaces a dozen paid Mac utilities
- Alishahryar1/free-claude-codeA local proxy that lets coding AI agents run on 49 free or cheap model providers instead of one paid service
- freestylefly/awesome-gpt-image-2A library of 532 reverse-engineered prompts that turn GPT-Image2 into a predictable image-making tool
- block/buzzAn open-source workspace where humans and AI agents chat, code, and review in the same rooms
- NousResearch/hermes-agentNous Research's Hermes is an AI agent that gets smarter the more you use it
- virgiliojr94/book-to-skillA tool that turns technical book PDFs into on-demand reference skills for AI coding agents
- VoltAgent/awesome-agent-skillsA single hub collecting over 1000 'how-to' manuals that make AI coding assistants act like experts
- anthropics/claude-plugins-communityA shared shelf where anyone's Claude add-ons get listed for install