You write the tasks.
Forgeo builds the software.

A scheduled factory for your repository. Forgeo organizes your work into a factory: keep a simple backlog of tasks, and it decides what to work on next, runs your agent, and commits the result. No branches, no pull requests. Progress, decisions, and history tracked in plain files, plus a web dashboard.

Get started Star on GitHub
terminal: install & launch your factory
$ curl -fsSL https://forgeo.org/install.sh | bash
forgeo init  ·  guided wizard in your project root  —  then forgeo start and watch it ship.

Works with Claude Code, Codex, opencode or any CLI agent: see the agent contract.

How it works

From backlog to shipped code, on repeat

Three steps and Forgeo runs forever, waking up on its own schedule and deciding what to do next.

01

Write your tasks

Describe what needs to be built in a plain JSON backlog, or just type it into the web console. One task at a time, in the order you wrote them.

02

The agent implements

Each cycle, Forgeo hands the oldest task to your coding agent, then commits and pushes the result straight to main.

03

Or refactors on its own

Empty backlog? The same agent reviews the codebase and cleans it up. Forgeo only interrupts you when a decision is genuinely yours.

See it running

A live dashboard, not a black box

Forgeo serves a live web dashboard while it works: every cycle, outcome, log line and blocker, visible at a glance. Running several factories? forgeo web gives you one dashboard for all of them.

http://0.0.0.0:8790
Forgeo web console dashboard

The Forgeo web console: every forgeo instance's backlog, run history and logs, in one dashboard at port 8790.

Why Forgeo

From loop engineering to software factory

Stop keeping the state of your work in your head. A backlog you can see, one task at a time, every result committed. Forgeo only interrupts you when a decision is genuinely yours.

Backlog-driven

A plain-JSON task list is the whole interface. Oldest task first, always one at a time, never overlapping runs.

Agent-agnostic

Any coding agent that can read an environment variable: Claude Code, Codex, opencode, or your own script.

No branches, no PRs

One repository, one branch, one commit per task. The noise of code review bureaucracy disappears.

Self-maintaining

When the backlog is empty the agent refactors: dead code, duplication, stale comments. Everything is kept tidy, automatically.

Stops when it must

If the agent hits a decision only a human can make, Forgeo writes BLOCKER.md, pauses, and waits for you.

Keeps you posted

One central dashboard that keeps track of the instances, plus optional Telegram notifications when your input is needed.

Bring your own agent: Forgeo orchestrates, your favourite CLI builds:

claude codex opencode any CLI script
Ready when you are

Start your factory tonight

Install with a one-liner, run forgeo init in your project, and let the agent do the work.

Read getting started Browse the docs