@bybrawe/opencode-loop 0.4.4 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.5.0
+
+- Added `opencode-loopd` background daemon for long-running loops outside the OpenCode TUI.
+- Added `opencode-loopd install-task` and `opencode-loopd uninstall-task` helpers for Windows Task Scheduler.
+- Updated README to clearly explain the difference between session-bound TUI loops and background daemon loops.
+- Added npm bin entry for `opencode-loopd`.
+- Updated package check script to validate the daemon script.
+
 ## 0.4.4
 
 - Made the npm install path the primary README installation method now that the package is published as `@bybrawe/opencode-loop`.

package/README.md

@@ -35,10 +35,11 @@ OpenCode Loop is designed for developers searching for:
 
 ## Features
 
-> Note: OpenCode Loop is session-bound. It runs while OpenCode is open and the session receives idle events. If the terminal closes, the machine sleeps, the process is killed, or the provider connection is lost for a long time, the loop cannot continue in the background. Use an external process manager or scheduled `opencode run` script for true daemon behavior.
+> Note: The TUI `/loop` command is session-bound. It runs while OpenCode is open and the session receives idle events. If the terminal closes, the machine sleeps, the process is killed, or the provider connection is lost for a long time, the TUI loop cannot continue in the background. For long-running loops, use `opencode-loopd` daemon mode.
 
 
-- **Claude Code style auto-continue** with `/loop 0s ...`.
+- **Claude Code style auto-continue** with `/loop 0s ...`.
+- **Background daemon mode** with `opencode-loopd` for long-running loops outside the OpenCode TUI.
 - **Interval loops** for prompts, slash commands, and shell commands.
 - **Prompt-file support** with `--prompt-file loop-prompt.md` for long reusable instructions.
 - **Include extra context files** with `--include-file`.
@@ -85,11 +86,67 @@ Test-fix loop:
 /loop 0s --name testfix --ask-never --safe --verify "npm test" Continue from progress.md. If tests fail, analyze the failure, fix it, and run the tests again.
 ```
 
-Shell command loop:
+Shell command loop:
+
+```text
+/loop 10m --name tests --safe !npm test
+```
+
+## Background daemon
+
+The `/loop` command is session-bound. It works while OpenCode is open and the current session emits idle/status events.
+
+If you close OpenCode, restart the terminal, lose connection, or your PC sleeps, the TUI loop will not keep running.
+
+For long-running loops, use the daemon:
+
+```bash
+opencode-loopd --project . --every 5m --prompt-file loop-prompt.md
+```
+
+Run immediately after each OpenCode turn:
+
+```bash
+opencode-loopd --project . --every 0s --prompt "continue from progress.md and implement the next unfinished TODO"
+```
+
+Limit runs:
+
+```bash
+opencode-loopd --project . --every 5m --max-runs 20 --prompt-file loop-prompt.md
+```
+
+Example `loop-prompt.md`:
+
+```md
+Continue from progress.md and implement the next unfinished TODO.
+
+Rules:
+- Do not ask questions.
+- Make reasonable assumptions.
+- Mark completed TODO items with [x].
+- Add useful follow-up TODOs when needed.
+- Run tests/lint/build when available.
+- Do not run destructive commands such as git reset, git clean, rm -rf, force push, deploy, or production migrations.
+- Keep going while work remains.
+```
+
+### Windows Task Scheduler
+
+You can create a Windows scheduled task that runs a one-shot daemon job every N minutes:
+
+```powershell
+opencode-loopd install-task --project "C:\path\to\project" --every 10m --prompt-file loop-prompt.md --name OpenCodeLoop
+```
+
+Remove it:
+
+```powershell
+opencode-loopd uninstall-task --name OpenCodeLoop
+```
+
+For active development, a visible terminal running `opencode-loopd --project . --every 0s ...` is easier to monitor.
 
-```text
-/loop 10m --name tests --safe !npm test
-```
 
 ## Installation
 
@@ -134,6 +191,12 @@ Then fully restart OpenCode and run:
 ```text
 /loop-help
 /loop-doctor
+```
+
+The npm package also installs the `opencode-loopd` CLI for background loops:
+
+```bash
+opencode-loopd --help
 ```
 
 ### Why `npx` is the recommended npm install

package/examples/loop-prompt.md

@@ -0,0 +1,10 @@
+Continue from progress.md and implement the next unfinished TODO.
+
+Rules:
+- Do not ask questions.
+- Make reasonable assumptions.
+- Mark completed TODO items with [x].
+- Add useful follow-up TODOs when needed.
+- Run tests/lint/build when available.
+- Do not run destructive commands such as git reset, git clean, rm -rf, force push, deploy, or production migrations.
+- Keep going while work remains.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bybrawe/opencode-loop",
-  "version": "0.4.4",
-  "description": "Claude Code style auto-continue /loop command for OpenCode: autonomous loops, compact scheduling, progress.md TODO automation, verification, checkpoints, and safe long-running coding sessions.",
+  "version": "0.5.0",
+  "description": "Claude Code style /loop command and background daemon for OpenCode: auto-continue, progress.md TODO automation, compact scheduling, verification, checkpoints, and safe autonomous coding loops.",
   "type": "module",
   "main": "src/index.js",
   "exports": {
@@ -17,7 +17,7 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "check": "node --check src/index.js",
+    "check": "node --check src/index.js && node --check scripts/install-node.mjs && node --check scripts/loopd.mjs",
     "install:global": "node scripts/install-node.mjs",
     "pack:zip": "node scripts/make-zip.mjs"
   },
@@ -36,7 +36,10 @@
     "scheduler",
     "progress-md",
     "todo-automation",
-    "ralph-loop"
+    "ralph-loop",
+    "daemon",
+    "background-runner",
+    "windows-task-scheduler"
   ],
   "author": "ByBrawe",
   "license": "MIT",
@@ -52,6 +55,7 @@
     "@opencode-ai/plugin": ">=1.4.0"
   },
   "bin": {
-    "opencode-loop": "./scripts/install-node.mjs"
+    "opencode-loop": "./scripts/install-node.mjs",
+    "opencode-loopd": "./scripts/loopd.mjs"
   }
 }

package/scripts/loopd.mjs

@@ -0,0 +1,205 @@
+#!/usr/bin/env node
+import fs from "node:fs"
+import path from "node:path"
+import { spawn, spawnSync } from "node:child_process"
+
+const args = process.argv.slice(2)
+
+function arg(name, fallback = null) {
+  const i = args.indexOf(name)
+  return i >= 0 ? args[i + 1] ?? fallback : fallback
+}
+
+function has(name) {
+  return args.includes(name)
+}
+
+function parseMs(value) {
+  const v = String(value || "0s").trim().toLowerCase()
+  if (v === "0" || v === "0s" || v === "now") return 0
+
+  const m = v.match(/^(\d+(?:\.\d+)?)\s*(ms|s|sec|secs|m|min|mins|h|hr|hrs|d|day|days)$/)
+  if (!m) throw new Error(`Invalid duration: ${value}`)
+
+  const n = Number(m[1])
+  const unit = m[2]
+
+  if (unit === "ms") return n
+  if (unit.startsWith("s")) return n * 1000
+  if (unit.startsWith("m")) return n * 60_000
+  if (unit.startsWith("h")) return n * 3_600_000
+  if (unit.startsWith("d")) return n * 86_400_000
+
+  return n
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms))
+}
+
+function run(command, cwd) {
+  return new Promise((resolve) => {
+    const child = spawn(command, {
+      cwd,
+      shell: true,
+      stdio: "inherit",
+      env: process.env,
+    })
+
+    child.on("exit", (code) => resolve(code ?? 0))
+  })
+}
+
+function readPrompt(project) {
+  const promptFile = arg("--prompt-file")
+  const promptArg = arg("--prompt")
+
+  if (promptFile) {
+    return fs.readFileSync(path.resolve(project, promptFile), "utf8")
+  }
+
+  if (promptArg) return promptArg
+
+  return [
+    "Continue from progress.md and implement the next unfinished TODO.",
+    "Do not ask questions.",
+    "Make reasonable assumptions.",
+    "Mark completed TODO items with [x].",
+    "Add useful follow-up TODOs when needed.",
+    "Run tests/lint/build when available.",
+    "Do not run destructive commands such as git reset, git clean, rm -rf, force push, deploy, or production migrations.",
+    "Keep going while work remains.",
+  ].join(" ")
+}
+
+async function daemon() {
+  const project = path.resolve(arg("--project", process.cwd()))
+  const every = arg("--every", "0s")
+  const delay = parseMs(every)
+  const maxRuns = Number(arg("--max-runs", "0")) || 0
+  const sleepFirst = has("--sleep-first")
+  const prompt = readPrompt(project)
+
+  console.log("OpenCode Loop daemon")
+  console.log(`project: ${project}`)
+  console.log(`every: ${every}`)
+  console.log(`maxRuns: ${maxRuns || "unlimited"}`)
+
+  let count = 0
+
+  if (sleepFirst && delay > 0) {
+    await sleep(delay)
+  }
+
+  while (true) {
+    count += 1
+
+    console.log("")
+    console.log(`[opencode-loopd] run #${count} ${new Date().toISOString()}`)
+
+    const command = `opencode run --continue --prompt ${JSON.stringify(prompt)}`
+    const code = await run(command, project)
+
+    if (code !== 0) {
+      console.log(`[opencode-loopd] opencode exited with code ${code}`)
+    }
+
+    if (maxRuns > 0 && count >= maxRuns) {
+      console.log("[opencode-loopd] max runs reached")
+      break
+    }
+
+    if (delay > 0) {
+      await sleep(delay)
+    }
+  }
+}
+
+function installTask() {
+  if (process.platform !== "win32") {
+    throw new Error("install-task is currently implemented for Windows Task Scheduler only. Use daemon mode on macOS/Linux.")
+  }
+
+  const project = path.resolve(arg("--project", process.cwd()))
+  const every = arg("--every", "10m")
+  const minutes = Math.max(1, Math.round(parseMs(every) / 60_000))
+  const name = arg("--name", "OpenCodeLoop")
+  const promptFile = arg("--prompt-file")
+  const promptArg = arg("--prompt")
+  const node = process.execPath
+  const script = path.resolve(new URL(import.meta.url).pathname)
+
+  const commandParts = [
+    `"${node}"`,
+    `"${script}"`,
+    "daemon",
+    "--project",
+    `"${project}"`,
+    "--every",
+    "0s",
+    "--max-runs",
+    "1",
+  ]
+
+  if (promptFile) commandParts.push("--prompt-file", `"${promptFile}"`)
+  if (promptArg) commandParts.push("--prompt", `"${promptArg.replaceAll('"', '\\"')}"`)
+
+  const taskCommand = commandParts.join(" ")
+  const schtasks = `schtasks /Create /F /SC MINUTE /MO ${minutes} /TN "${name}" /TR ${JSON.stringify(taskCommand)}`
+
+  console.log(schtasks)
+  const result = spawnSync(schtasks, { shell: true, stdio: "inherit" })
+  process.exit(result.status ?? 0)
+}
+
+function uninstallTask() {
+  if (process.platform !== "win32") {
+    throw new Error("uninstall-task is currently implemented for Windows Task Scheduler only.")
+  }
+
+  const name = arg("--name", "OpenCodeLoop")
+  const result = spawnSync(`schtasks /Delete /F /TN "${name}"`, { shell: true, stdio: "inherit" })
+  process.exit(result.status ?? 0)
+}
+
+function help() {
+  console.log(`
+OpenCode Loop daemon
+
+Usage:
+  opencode-loopd --project . --every 5m --prompt-file loop-prompt.md
+  opencode-loopd --project . --every 0s --prompt "continue from progress.md"
+  opencode-loopd install-task --project . --every 10m --prompt-file loop-prompt.md --name OpenCodeLoop
+  opencode-loopd uninstall-task --name OpenCodeLoop
+
+Options:
+  --project <path>       Project directory
+  --every <duration>     0s, 5m, 1h, etc.
+  --prompt <text>        Prompt text
+  --prompt-file <file>   Read prompt from file relative to the project
+  --max-runs <n>         Stop after n runs
+  --sleep-first          Wait before first run
+`)
+}
+
+const command = args[0]
+
+try {
+  if (command === "daemon" || command === "loopd") {
+    args.shift()
+    await daemon()
+  } else if (command === "install-task") {
+    args.shift()
+    installTask()
+  } else if (command === "uninstall-task") {
+    args.shift()
+    uninstallTask()
+  } else if (has("--help") || has("-h") || command === "help") {
+    help()
+  } else {
+    await daemon()
+  }
+} catch (error) {
+  console.error(error?.message || error)
+  process.exit(1)
+}