You write the tasks.
Forgeo builds the software.

A scheduled forgeo for your repository. You keep a simple list of tasks — an AI coding agent works through it, writing and committing real code to main. No branches, no pull requests, no developer on staff. If you can describe what to build, Forgeo can build it.

Get started Star on GitHub
terminal — install & launch your forgeo
$ 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, aider, 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

Engineering without an engineering team

Everything a small software org would do by hand, automated around a single repository and a single branch.

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, aider, 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 — 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

A web console for each forgeo, one central dashboard for all of them, plus optional Telegram notifications when your input is needed — nothing else disturbs you.

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

claude aider opencode codex any CLI script
Ready when you are

Start your forgeo 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