{
  "manifest_version": "1",
  "slug": "loopforge",
  "title": "LoopForge",
  "headline": "Self-host LoopForge",
  "description": "Run Tencent LoopForge on a private exe.dev VM: SOPs for coding agents with approval gates, Docker sandboxes, and Codex and Claude Code with no API keys.",
  "category": "ai-agents",
  "tags": [
    "loopforge",
    "tencent loopforge",
    "coding agents",
    "agent sop",
    "multi-agent",
    "human in the loop",
    "codex",
    "claude code",
    "codebuddy",
    "self-hosted"
  ],
  "url": "https://exe.dev/deploy/loopforge",
  "markdown_url": "https://exe.dev/deploy/loopforge.md",
  "upstream": {
    "source": "https://github.com/Tencent/LoopForge",
    "docs": "https://github.com/Tencent/LoopForge/blob/main/docs/deployment.md",
    "license": "MIT"
  },
  "example_vm_name": "my-loopforge",
  "time": "15 minutes",
  "stack": [
    {
      "name": "LoopForge 0.3.8",
      "detail": "ghcr.io/tencent/loopforge:0.3.8 in Docker Compose, with sign-up closed",
      "port": 8000,
      "data": "~/loopforge/.data and the platform-data volume"
    },
    {
      "name": "MySQL 8.4",
      "detail": "In the same Compose project, listening only on the VM",
      "data": "the mysql-data volume"
    },
    {
      "name": "Run sandboxes",
      "detail": "One container per SOP run, started by LoopForge through the VM's Docker"
    },
    {
      "name": "exe.dev LLM gateway",
      "detail": "GPT and Claude models for Codex and Claude Code, without API keys"
    }
  ],
  "access": [
    {
      "url": "https://my-loopforge.exe.xyz/",
      "who": "private",
      "what": "LoopForge, behind your exe.dev login and a LoopForge account"
    },
    {
      "url": "https://my-loopforge.exe.xyz/",
      "who": "shared",
      "what": "Teammates you share the VM with and give a LoopForge account"
    }
  ],
  "delivers": [
    "LoopForge 0.3.8 at your VM's private URL, behind your exe.dev login and its own accounts, with self sign-up closed.",
    "The first account, made by you in the browser, becomes the administrator; your password never passes through Shelley.",
    "LoopForge and MySQL back after a reboot.",
    "A nightly archive of the database, settings, and workspaces, kept two weeks, with a tested restore."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe.dev/new?prompt=Set%20up%20LoopForge%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe.dev%2Fdeploy%2Floopforge.md%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-loopforge.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-loopforge.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20LoopForge%200.3.8%20at%20your%20VM%27s%20private%20URL%2C%20behind%20your%20exe.dev%20login%20and%20its%20own%20accounts%2C%20with%20self%20sign-up%20closed.%0A-%20The%20first%20account%2C%20made%20by%20you%20in%20the%20browser%2C%20becomes%20the%20administrator%3B%20your%20password%20never%20passes%20through%20Shelley.%0A-%20LoopForge%20and%20MySQL%20back%20after%20a%20reboot.%0A-%20A%20nightly%20archive%20of%20the%20database%2C%20settings%2C%20and%20workspaces%2C%20kept%20two%20weeks%2C%20with%20a%20tested%20restore.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details.%20For%20initial%20setup%2C%0Afollow%20%22Install%20by%20hand%22%20first%2C%20skipping%20VM%20creation%20and%20SSH.%20Install%0Aexactly%20the%20pinned%20tag%2C%20v0.3.8.%20Don%27t%20set%20MIRROR.%0ANever%20open%20the%20LoopForge%20URL%20and%20never%20call%20%2Fapi%2Fauth%2Fregister%3A%20the%20first%0Aaccount%20becomes%20the%20administrator%2C%20and%20the%20owner%20must%20create%20it.%20Don%27t%0Aconfigure%20credentials%2C%20GitHub%2C%20projects%2C%20or%20SOPs%20yourself.%0AKeep%20the%20VM%20private.%20Never%20run%20share%20set-public%2C%20and%20never%20set%0AAGENTFLOW_ALLOW_SIGNUP%3Dtrue.%20On%20an%20existing%20VM%2C%20ask%20before%20replacing%0Aanything%20on%20port%208000.%0AVerify%3A%20%2Fapi%2Fhealth%20says%20ok%2C%20%2Fapi%2Fauth%2Fsetup%20says%20needsSetup%20true%2C%20both%0Acontainers%20have%20the%20unless-stopped%20restart%20policy%2C%20the%20image%20digest%0Amatches%2C%20and%20the%20test%20archive%20lists%20loopforge.sql%20and%20.env.%20Do%20not%0Areboot%2C%20and%20don%27t%20run%20the%20restore%20or%20update%20steps.%0AFinish%20with%20https%3A%2F%2FVM.exe.xyz%2F%20and%20tell%20the%20owner%20to%20create%20their%0Aadministrator%20account%20now%2C%20then%20follow%20%22Connect%20Codex%20and%20Claude%20Code%22.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe.dev/deploy/loopforge/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up LoopForge on this VM by following the exe.dev recipe at https://exe.dev/deploy/loopforge.md from top to bottom.\n\nThe recipe's example VM name is my-loopforge. This VM's name is the output of `hostname`: use it wherever the recipe writes my-loopforge. Skip the step that creates the VM; you are on it.\n\nYou are done when all of these are true. Check each one yourself:\n- LoopForge 0.3.8 at your VM's private URL, behind your exe.dev login and its own accounts, with self sign-up closed.\n- The first account, made by you in the browser, becomes the administrator; your password never passes through Shelley.\n- LoopForge and MySQL back after a reboot.\n- A nightly archive of the database, settings, and workspaces, kept two weeks, with a tested restore.\n\nRead the whole recipe, including the closed details. For initial setup,\nfollow \"Install by hand\" first, skipping VM creation and SSH. Install\nexactly the pinned tag, v0.3.8. Don't set MIRROR.\nNever open the LoopForge URL and never call /api/auth/register: the first\naccount becomes the administrator, and the owner must create it. Don't\nconfigure credentials, GitHub, projects, or SOPs yourself.\nKeep the VM private. Never run share set-public, and never set\nAGENTFLOW_ALLOW_SIGNUP=true. On an existing VM, ask before replacing\nanything on port 8000.\nVerify: /api/health says ok, /api/auth/setup says needsSetup true, both\ncontainers have the unless-stopped restart policy, the image digest\nmatches, and the test archive lists loopforge.sql and .env. Do not\nreboot, and don't run the restore or update steps.\nFinish with https://VM.exe.xyz/ and tell the owner to create their\nadministrator account now, then follow \"Connect Codex and Claude Code\".\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe.dev/deploy/loopforge/prompt.txt"
  },
  "updated": "2026-11-15",
  "verified": "2026-11-15",
  "related": [
    "paperclip",
    "openhands",
    "codex",
    "claude-code",
    "openclaw",
    "codex-remote-control"
  ]
}
