@bybrawe/opencode-loop 0.4.2 → 0.5.0

package/commands/loop-clear.md

@@ -1,5 +1,5 @@
 ---
-description: Clear all loop jobs for this session.
+description: OpenCode Loop plugin command.
 ---
 
-OpenCode Loop clear command. The plugin handles this command.
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-compact.md

@@ -1,5 +1,5 @@
 ---
-description: Preset compact loop. Usage: /loop-compact 200m
+description: OpenCode Loop plugin command.
 ---
 
-OpenCode Loop compact preset. The plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-dev.md

@@ -1,5 +1,5 @@
 ---
-description: Preset dev loop. Usage: /loop-dev 0s, /loop-dev 5m optional extra instruction
+description: OpenCode Loop plugin command.
 ---
 
-OpenCode Loop dev preset. The plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-doctor.md

@@ -1,5 +1,5 @@
 ---
-description: Diagnose the OpenCode Loop plugin installation and current session state.
+description: OpenCode Loop plugin command.
 ---
 
-Plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-export.md

@@ -1,5 +1,5 @@
 ---
-description: Export the current session loop state as JSON.
+description: OpenCode Loop plugin command.
 ---
 
-Plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-help.md

@@ -1,5 +1,5 @@
 ---
-description: Show OpenCode Loop help and examples.
+description: Show OpenCode Loop help.
 ---
 
-OpenCode Loop help command. The plugin handles this command.
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-init.md

@@ -1,5 +1,5 @@
 ---
-description: Create a starter progress.md file for autonomous OpenCode loop workflows.
+description: OpenCode Loop plugin command.
 ---
 
-Plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-logs.md

@@ -1,5 +1,5 @@
 ---
-description: Show recent OpenCode Loop log entries.
+description: Show OpenCode Loop logs.
 ---
 
-OpenCode Loop logs command. The plugin handles this command.
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-now.md

@@ -1,5 +1,5 @@
 ---
-description: Run loop jobs immediately. Usage: /loop-now, /loop-now <id|name|number>
+description: OpenCode Loop plugin command.
 ---
 
-OpenCode Loop run-now command. The plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-pause.md

@@ -1,5 +1,5 @@
 ---
-description: Pause loop jobs. Usage: /loop-pause, /loop-pause <id|name|number|all>
+description: OpenCode Loop plugin command.
 ---
 
-OpenCode Loop pause command. The plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-progress.md

@@ -1,5 +1,5 @@
 ---
-description: Preset progress.md loop. Usage: /loop-progress 0s or /loop-progress 5m
+description: OpenCode Loop plugin command.
 ---
 
-OpenCode Loop progress preset. The plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-remove.md

@@ -1,5 +1,5 @@
 ---
-description: Remove loop jobs. Alias of /loop-stop. Usage: /loop-remove <id|name|number|all>
+description: OpenCode Loop plugin command.
 ---
 
-OpenCode Loop remove command. The plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-resume.md

@@ -1,5 +1,5 @@
 ---
-description: Resume loop jobs. Usage: /loop-resume, /loop-resume <id|name|number|all>
+description: OpenCode Loop plugin command.
 ---
 
-OpenCode Loop resume command. The plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-safe-dev.md

@@ -1,5 +1,5 @@
 ---
-description: Preset safe dev loop with ask-never, safe mode, batch 5 and checkpoint-only. Usage: /loop-safe-dev 0s
+description: OpenCode Loop plugin command.
 ---
 
-OpenCode Loop safe-dev preset. The plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-status.md

@@ -1,5 +1,5 @@
 ---
-description: Show active OpenCode loop jobs for this session.
+description: Show OpenCode Loop status.
 ---
 
-OpenCode Loop status command. The plugin handles this command.
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-stop.md

@@ -1,5 +1,5 @@
 ---
-description: Stop loop jobs. Usage: /loop-stop, /loop-stop all, /loop-stop <id|name|number>
+description: Stop OpenCode Loop jobs.
 ---
 
-OpenCode Loop stop command. The plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-testfix.md

@@ -1,5 +1,5 @@
 ---
-description: Preset test-fix loop. Usage: /loop-testfix 0s "npm test"
+description: OpenCode Loop plugin command.
 ---
 
-OpenCode Loop test-fix preset. The plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop.md

@@ -1,5 +1,5 @@
 ---
-description: Start an OpenCode idle/interval loop. Usage: /loop 0s prompt, /loop 5m --safe --ask-never prompt, /loop 200m /compact, /loop --watch progress.md prompt
+description: Start an OpenCode auto-continue loop. Usage: /loop 5m <task>
 ---
 
-OpenCode Loop command. The plugin handles this command. Arguments: $ARGUMENTS
+Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

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.2",
-  "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)
+}

package/src/index.js

@@ -186,6 +186,7 @@ function parseLoopArgs(raw, defaults = {}) {
     gitCheckpoint: defaults.gitCheckpoint ?? false,
     checkpointOnly: defaults.checkpointOnly ?? false,
     dryRun: defaults.dryRun ?? false,
+    multi: defaults.multi ?? false,
     batch: defaults.batch ?? 0,
     runCount: 0,
     failureCount: 0,
@@ -212,6 +213,8 @@ function parseLoopArgs(raw, defaults = {}) {
   ;[found, rest] = takeFlag(rest, "--checkpoint-only"); if (found) job.checkpointOnly = true
   ;[found, rest] = takeFlag(rest, "--pause-on-verify-fail"); if (found) job.pauseOnVerifyFail = true
   ;[found, rest] = takeFlag(rest, "--dry-run"); if (found) job.dryRun = true
+  ;[found, rest] = takeFlag(rest, "--multi"); if (found) job.multi = true
+  ;[found, rest] = takeFlag(rest, "--replace"); if (found) job.multi = false
 
   ;[value, rest] = takeFlagValue(rest, "--name"); if (value !== undefined) job.name = value.trim()
   ;[value, rest] = takeFlagValue(rest, "--max-runs"); if (value !== undefined) job.maxRuns = parsePositiveInt(value, 0)
@@ -606,7 +609,7 @@ async function fireAction(directory, client, sessionID, job) {
     return { startsAssistantTurn: true }
   }
   const prompt = await buildPrompt(directory, job)
-  client.session.prompt({ path: { id: sessionID }, body: { parts: [{ type: "text", text: `OpenCode loop continuation. Continue autonomously like Claude Code loop mode.\n\n${prompt}` }] } }).catch(() => {})
+  client.session.prompt({ path: { id: sessionID }, body: { parts: [{ type: "text", text: `AUTONOMOUS OPENCODE LOOP ITERATION. Continue the configured task now. Do not explain the /loop command. Do not search for documentation about this plugin. Do not create scheduler files. Do not ask questions. Make reasonable assumptions and work directly.\n\n${prompt}` }] } }).catch(() => {})
   return { startsAssistantTurn: true }
 }
 
@@ -699,16 +702,47 @@ async function maybeRunDueJobs(directory, client, sessionID, options = {}) {
   }
 }
 
+function normalizeActionForCompare(value) {
+  return String(value || "").replace(/\s+/g, " ").trim()
+}
+
+function sameLoopDefinition(a, b) {
+  if (!a || !b) return false
+  return (a.name || "") === (b.name || "") &&
+    Number(a.intervalMs || 0) === Number(b.intervalMs || 0) &&
+    normalizeActionForCompare(a.action) === normalizeActionForCompare(b.action) &&
+    normalizeActionForCompare(a.promptFile) === normalizeActionForCompare(b.promptFile)
+}
+
 async function addLoop(directory, client, sessionID, args, defaults = {}) {
   const parsed = parseLoopArgs(args, defaults)
   if (!parsed.ok) { await toast(client, parsed.error, "warning"); return }
   if (parsed.job.watchPaths.length) parsed.job.watchSnapshot = await snapshotPaths(directory, parsed.job.watchPaths)
   if (parsed.job.dryRun) { await toast(client, `Loop dry run: ${jobLabel(parsed.job)}`, "info"); await say(client, sessionID, "OpenCode loop dry run:\n```json\n" + JSON.stringify(parsed.job, null, 2) + "\n```"); return }
   const state = await readState(directory, sessionID)
+  const jobs = Array.isArray(state.jobs) ? state.jobs : []
+
+  // Default behavior is replace/upsert, not append forever. This prevents duplicate
+  // loops when OpenCode emits both command.execute.before and command.executed,
+  // and it matches the common expectation that /loop configures the current loop.
+  let replaced = false
+  if (!parsed.job.multi) {
+    const targetName = parsed.job.name || "default"
+    parsed.job.name = targetName
+    state.jobs = jobs.filter((existing) => {
+      const existingName = existing.name || "default"
+      const shouldReplace = existingName === targetName || sameLoopDefinition(existing, parsed.job)
+      if (shouldReplace) replaced = true
+      return !shouldReplace
+    })
+  } else {
+    state.jobs = jobs
+  }
+
   state.jobs.push(parsed.job)
   await writeState(directory, sessionID, state)
-  await toast(client, `Loop added: ${jobLabel(parsed.job)}`, "success")
-  await appendLoopLog(directory, "add", { sessionID, job: parsed.job.name || parsed.job.id, label: jobLabel(parsed.job) })
+  await toast(client, `${replaced ? "Loop replaced" : "Loop added"}: ${jobLabel(parsed.job)}`, "success")
+  await appendLoopLog(directory, replaced ? "replace" : "add", { sessionID, job: parsed.job.name || parsed.job.id, label: jobLabel(parsed.job) })
 }
 
 async function stopLoop(directory, client, sessionID, args) {