---
title: Loop — OpenCode V2 Plugin by Jad Madi (@jadmadi)
description: >-
  Runs a prompt on a fixed cadence, skipping a tick while the previous run is
  still active.
href: /project/opencode-plugins/loop/
category: Autonomy and workflow
version: 2026.9.0
builtUnder: 2.0.16
license: MIT
repo: 'https://github.com/jadmadi/opencode-loop'
author: Jad Madi
runtime: OpenCode V2
telemetry: 0% (Local First)
installCommand: 'opencode plugin add github:jadmadi/opencode-loop'
tags:
  - loop
  - schedule
  - cadence
  - autonomy
---
# Loop — OpenCode V2 Plugin

Runs a prompt on a fixed cadence, skipping a tick while the previous run is still active.

- **Website**: https://jadmadi.net/project/opencode-plugins/loop/
- **Repository**: https://github.com/jadmadi/opencode-loop
- **Category**: Autonomy and workflow
- **Version**: v2026.9.0 (CalVer)
- **Tested Runtime**: OpenCode v2.0.16
- **License**: MIT
- **Artifact**: `loop.ts`
- **Updated**: 2026-09-25
- **Author**: [@JadMadi](https://x.com/jadmadi)

## Quick Install

Install with a single command in OpenCode V2:

```bash
opencode plugin add github:jadmadi/opencode-loop
```

### Manual / Local Install

Copy loop.ts into ~/.config/opencode/plugins/ and restart the TUI.

## The Problem It Solves

Recurring checks need a timer, but naive timers fire while the last run is still going and pile work up.

## What It Does

Runs a prompt on a fixed cadence, skipping a tick while the previous run is still active.

## Slash Commands

| Command | Description |
| :--- | :--- |
| `/loop` | Register, list, or stop a recurring prompt on a fixed cadence. |

## Limitations & Safety Rules

One loop per session, because the turn-end event names the session, not the run.

## Frequently Asked Questions (Agent Q&A)

### Q: What problem does Loop solve?
Recurring checks need a timer, but naive timers fire while the last run is still going and pile work up.

### Q: How do I install and run Loop?
Run `opencode plugin add github:jadmadi/opencode-loop` in your terminal.

### Q: Does this plugin transmit telemetry or code externally?
No. It operates with 0% telemetry, local-first in ~/.config/opencode/plugins/.

## Links & Resources

- Dedicated Page: https://jadmadi.net/project/opencode-plugins/loop/
- All OpenCode Plugins: https://jadmadi.net/project/opencode-plugins/
- GitHub Repository: https://github.com/jadmadi/opencode-loop
- Changelog: https://github.com/jadmadi/opencode-loop/blob/main/CHANGELOG.md
- Author Profile: https://jadmadi.net/about/