Skip to content
jkrandom-sudo edited this page Jul 18, 2026 · 2 revisions

opencode-plugin-loop

opencode-plugin-loop adds a session-scoped /loop command to OpenCode. It can run prompts on fixed or adaptive schedules, persist tasks across restarts, and display command results in a responsive native dialog without writing over the prompt.

Highlights

  • Fixed, adaptive, and maintenance loop modes
  • Strict per-session task ownership
  • Persistent tasks with deterministic jitter and automatic cleanup
  • list, status, cancel, pause, resume, and stop-all commands
  • Copy ID, Copy all, and Close actions in a keyboard- and mouse-accessible dialog
  • LLM-callable loop_schedule and loop_status tools

Requirements

  • OpenCode 1.17.18 or newer
  • Node.js 18 or newer

Install or upgrade

opencode plugin opencode-plugin-loop --global --force

Restart OpenCode after installation. The unversioned package name lets the same command install future releases without editing configuration files.

Documentation

  • User Guide — installation, commands, dialog controls, and configuration
  • Troubleshooting — cache, version, duplicate-loading, and TUI recovery steps
  • Development — architecture, source workflow, build, and testing

Project links

Clone this wiki locally