# LoopForge

> Open-source, self-hosted platform that orchestrates coding agents through reusable SOPs, cloud sandboxes, script gates and human approval for software delivery.

LoopForge is an open-source, self-hosted AI software delivery workspace from Tencent, released under the MIT license. Teams describe work to a Main Bot in chat or run a saved SOP, and coding-agent CLIs do the work inside Docker sandboxes with real repositories. Builds and tests are checked by command exit codes, and human gates sit before anything ships.

## What It Is

LoopForge is a delivery layer around coding-agent CLIs such as CodeBuddy, Codex, Claude Code, OpenCode, Cursor CLI, Antigravity, Kimi Code, Pi, DeepSeek Harness and ZCode. It adds roles, sandboxes, checkpoints and run history around them. In chat, Main Bot opens a conversation workspace, checks out repositories, delegates to project roles and opens a pull request or merge request. Product, design and engineering can share one team session, and generated documents appear in an artifact drawer for preview and download.

## How SOPs Work

An SOP is a reusable workflow built on a visual canvas from Agent, Script, Human gate, Sub-SOP and Preview build nodes. A typical flow runs Clarify, Design, Implement, Review, Run tests and Sign-off. Each node declares its artifacts and dependencies. Each role carries its own prompt, executor, model, rules, Skills and MCP tools. Script nodes decide by exit code, and failed checks send work back to an earlier step with the error log. Four built-in SOPs cover backend delivery, frontend delivery, product proposal and bug fix. Runs can be paused, retried, rerun from any node or taken over from chat.

## Automation and Review

The platform can sync GitHub Issues on a schedule, run fixes in parallel and resolve merge conflicts on an integration branch. It also runs recurring AI scheduled tasks. After each run, an automated evaluation scores the run from 0 to 100, points out rework bottlenecks and proposes updates to SOP steps, role guides and quality gates. Insights pages report engineering metrics and token and cost accounting.

## Deployment Options

The platform installs with ./start.sh and needs Docker with Compose and Python 3. It pulls a release image, sets up MySQL and the platform services, and installs built-in sandboxes and starter SOPs. A demo SOP made of a script and a human gate runs without any API key. Real agent work needs credentials for the chosen executor, and GitHub is optional. The README says new installations target trusted teams and recommends reading the account and access model before exposing the service. LoopForge Local installs the built-in workflows into Claude Code, CodeBuddy, Codex, Cursor, Pi, DeepSeek Harness or Hermes Agent via loopforge-cli, and needs Node.js 20+ and Python 3.8+.

## Features
- Chat workbench with Main Bot and per-conversation executor, model and permission mode
- On-demand Docker conversation workspaces with repositories checked out
- Visual SOP designer with Agent, Script, Human gate, Sub-SOP and Preview build nodes
- Hard quality gates verified by command exit codes with automatic rework on failure
- Human approval gates and a Needs review inbox
- Reusable roles with prompt, executor, model, rules, Skills and MCP tools
- Pause, resume, retry, rerun from any node or take over a running workspace
- Scheduled GitHub Issue sync with parallel fixes and merge conflict resolution
- Automated post-run evaluation scoring runs 0-100 with one-click SOP improvements
- Requirement-to-delivery tracking with PR/MR status
- Token and cost accounting and engineering insights
- LoopForge Local workflows for coding assistants via loopforge-cli
- OpenAPI-described HTTP and MCP API

## Integrations
CodeBuddy, Codex, Claude Code, OpenCode, Cursor CLI, Antigravity, Kimi Code, Pi, DeepSeek Harness, ZCode, Hermes Agent, GitHub, MCP, Docker

## Platforms
WINDOWS, MACOS, LINUX, WEB, API, CLI

## Pricing
Open Source

## Version
v0.4.0

## Links
- Website: https://loopforge.cn
- Documentation: https://loopforge.cn/docs/
- Repository: https://github.com/Tencent/LoopForge
- EveryDev.ai: https://www.everydev.ai/tools/loopforge
