From 0ca7d343f76d5fcdd9848d8e7fc042efab52c851 Mon Sep 17 00:00:00 2001
From: BillyOutlast <172061051+BillyOutlast@users.noreply.github.com>
Date: Sat, 17 Oct 2026 01:47:48 -0400
Subject: [PATCH] docs: add opencode-todo-supervisor to plugins (#501)

Co-authored-by: n0k0 <github@hacky.software>
---
 data/plugins/opencode-todo-supervisor.yaml | 65 ++++++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 data/plugins/opencode-todo-supervisor.yaml

diff --git a/data/plugins/opencode-todo-supervisor.yaml b/data/plugins/opencode-todo-supervisor.yaml
new file mode 100644
index 0000000..a36f105
--- /dev/null
+++ b/data/plugins/opencode-todo-supervisor.yaml
@@ -0,0 +1,65 @@
+name: OpenCode Todo Supervisor
+repo: https://github.com/N0K0/opencode-todo-supervisor
+tagline: Session todo lists, plus a supervisor that keeps nudging idle sessions until the list is done
+description: >-
+  Gives every OpenCode V2 session a real todo list and then keeps the agent working on it.
+  Ships todo_write, todo_read, todo_add and todo_remove tools (V2 ships none), stored per
+  session with stable per-item ids, with a live progress strip in the composer. A supervisor
+  re-prompts any session that goes idle while its list still has open items, and stays quiet
+  while the agent is actually working, including during tool calls, subagent runs and
+  background shells. Any markdown file can be subscribed so its GFM checklists count as
+  todos, and the TUI panel can tick them off by hand. Nudges are delivered as synthetic
+  session input, so the model reads them as ordinary instructions. Tested against 2.0.24.
+scope:
+  - global
+  - project
+tags:
+  - todo
+  - task-tracking
+  - productivity
+  - automation
+  - tui
+min_version: "2.0.0"
+installation: |
+  ## Install
+
+  ```sh
+  opencode plugin add @hacky.software/opencode-todo-supervisor
+  ```
+
+  Or list it in `opencode.json`:
+
+  ```json
+  {
+    "$schema": "https://opencode.ai/config.json",
+    "plugins": ["@hacky.software/opencode-todo-supervisor"]
+  }
+  ```
+
+  ## Configuration
+
+  Options are optional; the defaults supervise quietly in the background.
+
+  ```jsonc
+  {
+    "$schema": "https://opencode.ai/config.json",
+    "plugins": [
+      {
+        "package": "@hacky.software/opencode-todo-supervisor",
+        "options": {
+          "stallMinutes": 5,           // idle time before the first nudge
+          "minNudgeIntervalMs": 45000, // rate limit between nudges
+          "maxNoProgressNudges": 5,    // give up after this many no-progress nudges
+          "injectTodoContext": true,   // remind the model of the list on each prompt
+          "markdownFiles": ["PLAN.md"] // treat these files' checklists as the todo list
+        }
+      }
+    ]
+  }
+  ```
+
+  ## Usage
+
+  Ask the agent to plan with `todo_write`, then check `todo_read`. In the TUI the composer
+  strip shows progress; open the panel from the command palette to add, remove or reorder
+  items, and to check off markdown checklist items.