Session-tied fixed-delay loops for OpenCode.
{
"plugin": ["@malico/opencode-loop"]
}For local testing before publish, copy the built plugin into OpenCode's global plugins directory:
make install-localOr reference the built file directly in your config:
{
"plugin": ["file:///Users/malico/tinkerbin/opencode-loop/dist/index.js"]
}Usage:
/loop every 5 mins check this
/loop every 30 mins write the next article section --auto-compact
/loop remember every day to check this
/loop status
/loop cancel the current loops
Test locally with make check.
Intervals are fixed-delay. If a 5 minute loop takes 10 minutes to run, the next run starts 5 minutes after it finishes.
New loops queue their first iteration after OpenCode reports the current session idle. The run-specific [loop:evidence:<run_id>] marker is advisory; a finished turn completes the iteration. An explicit [loop:blocked] marker pauses the loop, while a response-inspection failure pauses it as unverified.
Add --auto-compact to compact the session after each completed iteration. Triggering loop_now during an active iteration queues one immediate follow-up run.
State is stored in ~/.config/opencode/loops/loops.db. Loops are tied to OpenCode session IDs.
OpenCode's own opencode.db is not used for plugin state because plugin APIs do not expose a stable extension table or migration hook. Loop rows store OpenCode sessionId so runs can still be linked back to OpenCode sessions.