Getting started

Install Forge on a fresh repository, answer five questions, set one secret, and open your first issue.

Forge runs inside your GitHub repository. There’s nothing to host and no dashboard to babysit — the loop lives in GitHub Actions and ships to Vercel.

Install

npx create-forge@latest my-site
cd my-site
node scripts/init.mjs        # 5 questions → forge.config.yml

Set one secret

claude setup-token          # paste the result as a repo secret:
                            #   CLAUDE_CODE_OAUTH_TOKEN

Every other provider key is optional. If you add OPENAI_API_KEY or GEMINI_API_KEY, Forge uses them as fallback lanes automatically.

Open your first issue

Describe what you want in plain language:

“Add a contact page with a lead form that emails hello@ and shows a success state.”

Forge triages it, writes a plan, implements it on a branch, opens a PR, has a second vendor review it, and merges once checks pass. Watch it from your phone.

Next steps