{
  "manifest_version": "1",
  "slug": "agent-autoloop",
  "title": "Agent Autoloop",
  "headline": "Run Agent Autoloop on an always-on server",
  "description": "Run Agent Autoloop on an exe.dev VM: Claude Code and Codex take jobs from cron, GitHub webhooks and HTTP, and ask you in Slack or Discord.",
  "category": "ai-agents",
  "tags": [
    "agent-autoloop",
    "agent automation",
    "background agents",
    "claude code cron",
    "codex cron",
    "github webhooks",
    "slack approvals",
    "discord approvals",
    "human in the loop"
  ],
  "url": "https://exe.dev/deploy/agent-autoloop",
  "markdown_url": "https://exe-staging.dev/deploy/agent-autoloop.md",
  "upstream": {
    "website": "https://github.com/KKKKhazix/agent-autoloop",
    "source": "https://github.com/KKKKhazix/agent-autoloop",
    "docs": "https://github.com/KKKKhazix/agent-autoloop/blob/main/README.en.md",
    "license": "MIT"
  },
  "example_vm_name": "my-agent-autoloop",
  "time": "15 minutes",
  "stack": [
    {
      "name": "Agent Autoloop hub and worker",
      "detail": "`agent-autoloop up` on Node.js 24, the agent-autoloop systemd user service",
      "port": 3350,
      "data": "~/.agent-autoloop"
    },
    {
      "name": "Claude Code and Codex",
      "detail": "preinstalled; connected to exe.dev's LLM integration",
      "data": "~/.claude, ~/.codex"
    },
    {
      "name": "nginx",
      "detail": "passes two webhook paths from the public address to the hub",
      "port": 8000
    },
    {
      "name": "Your project",
      "data": "~/project"
    }
  ],
  "access": [
    {
      "url": "https://my-agent-autoloop.exe.xyz/v1/in/github",
      "who": "public",
      "what": "GitHub webhooks, signed with your secret"
    },
    {
      "url": "https://my-agent-autoloop.exe.xyz/v1/events",
      "who": "public",
      "what": "events from your scripts and CI, each with a source key"
    },
    {
      "url": "https://my-agent-autoloop.exe.xyz:3350/c/",
      "who": "private",
      "what": "the approval pages that cards link to, and the rest of the hub's API; you and anyone you share the VM with"
    },
    {
      "url": "ssh my-agent-autoloop.exe.xyz",
      "who": "private",
      "what": "the agent-autoloop CLI, rules and logs"
    }
  ],
  "delivers": [
    "Agent Autoloop 1.8 or later running as a systemd user service that comes back after a reboot",
    "Claude Code and Codex answering through exe.dev's LLM integration, with `agent-autoloop try` passing",
    "Three example rules: a daily Codex brief on cron, a CI-triggered Claude Code fix that asks first, and read-only triage of new GitHub issues",
    "A GitHub webhook secret and a CI source key, in files only the exedev user can read",
    "nginx on port 8000 passing only `/v1/in/github` and `/v1/events` to the hub, which stays on 127.0.0.1:3350",
    "Cards sent to Slack or Discord through an exe.dev integration, if one is attached to the VM"
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=Set%20up%20Agent%20Autoloop%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Fagent-autoloop.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-agent-autoloop.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-agent-autoloop.%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-%20Agent%20Autoloop%201.8%20or%20later%20running%20as%20a%20systemd%20user%20service%20that%20comes%20back%20after%20a%20reboot%0A-%20Claude%20Code%20and%20Codex%20answering%20through%20exe.dev%27s%20LLM%20integration%2C%20with%20%60agent-autoloop%20try%60%20passing%0A-%20Three%20example%20rules%3A%20a%20daily%20Codex%20brief%20on%20cron%2C%20a%20CI-triggered%20Claude%20Code%20fix%20that%20asks%20first%2C%20and%20read-only%20triage%20of%20new%20GitHub%20issues%0A-%20A%20GitHub%20webhook%20secret%20and%20a%20CI%20source%20key%2C%20in%20files%20only%20the%20exedev%20user%20can%20read%0A-%20nginx%20on%20port%208000%20passing%20only%20%60%2Fv1%2Fin%2Fgithub%60%20and%20%60%2Fv1%2Fevents%60%20to%20the%20hub%2C%20which%20stays%20on%20127.0.0.1%3A3350%0A-%20Cards%20sent%20to%20Slack%20or%20Discord%20through%20an%20exe.dev%20integration%2C%20if%20one%20is%20attached%20to%20the%20VM%0A%0ARun%20every%20section%20of%20%22Set%20up%20the%20VM%22%20in%20order%2C%20skipping%20VM%20creation.%0ABefore%20any%20%60agent-autoloop%60%20command%20that%20installs%20or%20restarts%20the%0Aservice%2C%20run%20%60export%20XDG_RUNTIME_DIR%3D%2Frun%2Fuser%2F%24%28id%20-u%29%60%20in%20the%20same%0Ashell%2C%20or%20systemctl%20--user%20can%27t%20reach%20the%20user%20manager.%20%60agent-autoloop%0Atry%60%20stops%20at%20a%20question%3A%20answer%20it%20with%20%60agent-autoloop%20answer%20%3Ccard%3E%202%60%0Aand%20check%20that%20%60agent-autoloop%20status%60%20shows%20the%20try%20run%20passed.%20In%0A%22Send%20cards%20to%20Slack%20or%20Discord%22%2C%20look%20for%20an%20attached%20integration%20of%0Atype%20slack%20or%20discord%20with%20%60curl%20-s%20https%3A%2F%2Freflection.int.exe.xyz%2Fintegrations%60%3B%0Aif%20there%20is%20one%2C%20wire%20it%20in%2C%20and%20if%20there%20isn%27t%2C%20skip%20that%20step%20and%20tell%0Athe%20owner%20how%20to%20add%20one.%20Never%20print%20the%20webhook%20secret%20or%20the%20CI%20key.%0ADon%27t%20run%20%60share%20set-public%60%20%28only%20the%20owner%20can%29%2C%20and%20don%27t%20register%20a%0AGitHub%20webhook.%20Finish%20by%20telling%20the%20owner%20the%20webhook%20URL%0A%60https%3A%2F%2F%3Cthis%20VM%27s%20name%3E.exe.xyz%2Fv1%2Fin%2Fgithub%60%2C%20where%20the%20secret%20is%0A%28%60~%2F.agent-autoloop%2Fsecrets.env%60%29%2C%20and%20that%20%60ssh%20exe.dev%20share%0Aset-public%20%3Cthis%20VM%27s%20name%3E%60%20on%20their%20computer%20makes%20that%20path%20reachable.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/agent-autoloop/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "Set up Agent Autoloop on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/agent-autoloop.md?via=deploy from top to bottom.\n\nThe recipe's example VM name is my-agent-autoloop. This VM's name is the output of `hostname`: use it wherever the recipe writes my-agent-autoloop. 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- Agent Autoloop 1.8 or later running as a systemd user service that comes back after a reboot\n- Claude Code and Codex answering through exe.dev's LLM integration, with `agent-autoloop try` passing\n- Three example rules: a daily Codex brief on cron, a CI-triggered Claude Code fix that asks first, and read-only triage of new GitHub issues\n- A GitHub webhook secret and a CI source key, in files only the exedev user can read\n- nginx on port 8000 passing only `/v1/in/github` and `/v1/events` to the hub, which stays on 127.0.0.1:3350\n- Cards sent to Slack or Discord through an exe.dev integration, if one is attached to the VM\n\nRun every section of \"Set up the VM\" in order, skipping VM creation.\nBefore any `agent-autoloop` command that installs or restarts the\nservice, run `export XDG_RUNTIME_DIR=/run/user/$(id -u)` in the same\nshell, or systemctl --user can't reach the user manager. `agent-autoloop\ntry` stops at a question: answer it with `agent-autoloop answer \u003ccard\u003e 2`\nand check that `agent-autoloop status` shows the try run passed. In\n\"Send cards to Slack or Discord\", look for an attached integration of\ntype slack or discord with `curl -s https://reflection.int.exe.xyz/integrations`;\nif there is one, wire it in, and if there isn't, skip that step and tell\nthe owner how to add one. Never print the webhook secret or the CI key.\nDon't run `share set-public` (only the owner can), and don't register a\nGitHub webhook. Finish by telling the owner the webhook URL\n`https://\u003cthis VM's name\u003e.exe.xyz/v1/in/github`, where the secret is\n(`~/.agent-autoloop/secrets.env`), and that `ssh exe.dev share\nset-public \u003cthis VM's name\u003e` on their computer makes that path reachable.\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe-staging.dev/deploy/agent-autoloop/prompt.txt"
  },
  "updated": "2026-11-15",
  "verified": "2026-11-15",
  "related": [
    "claude-code",
    "codex",
    "github-actions",
    "herdr",
    "deepseek-harness",
    "hermes-agent"
  ]
}
