opencode-auto-todos

opencode-auto-todos

An OpenCode plugin that automatically appends custom todos to every task list. Define your standard workflow items once, and they'll be added to every todowrite call automatically.

Use Cases

• Version bump reminder — Never forget to bump versions before merging
• GitHub workflow — Always create branch, commit, and open PR
• Code review checklist — Add standard review items to every feature
• Deployment steps — Ensure deploy-related tasks are always tracked

Installation

# In your project directory
npm install --save-dev opencode-auto-todos

Then add to your opencode.json:

{
  "plugin": ["opencode-auto-todos"]
}

Configuration

Create an auto-todos.json file in your project root or inside .opencode/:

{
  "todos": [
    {
      "content": "Version bump - update version in package.json",
      "priority": "medium",
      "match": "version bump",
      "order": "first"
    },
    {
      "content": "Create branch, commit changes, open PR",
      "priority": "medium",
      "match": "github",
      "order": 2
    }
  ],
  "always": false,
  "deduplicate": true
}

Config Options

Field	Type	Default	Description
todos	AutoTodo[]	required	List of todos to automatically add
always	boolean	false	If true, add todos to every todowrite call. If false, only when the list is first created (empty).
deduplicate	boolean	true	Skip adding a todo if a similar one already exists in the list.

AutoTodo Shape

Field	Type	Required	Description
content	string	yes	The todo text to display
priority	"high" | "medium" | "low"	no	Priority level (default: "medium")
match	string	no	Substring to match against existing todos for deduplication. If omitted, content is used.
order	"first" | "last" | number	no	Position where the todo is inserted (default: "last"). "first" = beginning, "last" = end, number = 1-based index (e.g., 1 = first, 2 = second).

How It Works

• The plugin hooks into OpenCode's tool.execute.before event for the todowrite tool
• Before any todo list is written, it checks the config file
• It appends your configured todos to the list (unless they already exist)
• The model then sees the complete list including your standard items

Example

With this config:

{
  "todos": [
    { "content": "Read CLAUDE.md or project docs", "order": "first" },
    { "content": "Version bump", "match": "version" },
    { "content": "Create branch, commit, open PR", "match": "github" }
  ]
}

Every time you start a new feature, the agent's todo list will automatically include:

✓ [your feature-specific todos]
☐ Read CLAUDE.md or project docs
☐ Version bump
☐ Create branch, commit, open PR

License

MIT