lucaGazzola

Forgeo — Productivity skill for Claude Code

Productivity community

A scheduled, agent-driven software factory.

How to install Forgeo

This entry records only its repository, not the path inside it, so there is no exact command to give. Open lucaGazzola/forgeo and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Forgeo does

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.

Alternatives in Productivity

Epic Decompose — Break an epic into task children without creating task branches 243.5k ★
Grow A Product — Workflow recipe — turn a growth goal into a funnel diagnosis, experiment backlog, retention loop, and lifecycl 1.3k ★
Maestro Issue — Intent-driven issue lifecycle management — describe what you want in natural language (报告一个 bug / 列出开放 issue / 530 ★

README

[![CI](https://github.com/lucaGazzola/forgeo/actions/workflows/ci.yml/badge.svg)](https://github.com/lucaGazzola/forgeo/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Forgeo running a backlog task end to end

**Forgeo is a software factory for your coding-agent.** You're already working with an AI coding agent, prompting it task by task or giving it a goal. Forgeo organizes your work in a structured way with a backlog, and it decides what to work on next, runs your agent on it, and commits the result. Progress, pending decisions, and history are tracked in plain files you can inspect at any time, plus a web dashboard. Forgeo only interrupts you when a decision is genuinely yours to make, everything else happens autonomously. Transient failures (a network blip, a flaky test) are retried automatically when the retry policy is enabled, and only a task that keeps failing or genuinely needs a human decision ever reaches you.

All you need is basic comfort with a terminal, a git repository, and any coding agent CLI.

Quickstart

The full walkthrough is in [Getting started](docs/getting-started.md).

1. Install the CLI

Pick any one installer (no root needed; re-running it upgrades Forgeo).

# Homebrew (macOS / Linux): prebuilt binary, no Python required
brew install lucaGazzola/forgeo/forgeo

# One-liner (Linux / macOS / Windows): prebuilt binary, falls back to pip
curl -fsSL https://forgeo.org/install.sh | bash

# pip (Python 3.11+)
pipx install forgeo-cli