Tiny Goal
A tiny goal plugin for opencode 2.x: /goal keeps the agent working until the goal is done, without nagging while background work runs.
0
342
342 in 7 days
35.6
Multi-signal model
18 hours ago
2026-10-20
Install and configure
opencode.jsonWrites to this project's opencode.json — applies to this repository only.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-tiny-goal@0.1.4"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-tiny-goal@0.1.4"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D opencode-tiny-goalOpenCode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
Give opencode a goal, and it keeps working until the goal is done.
For opencode 2.x.
Install
opencode plugin add opencode-tiny-goal
Restart opencode.
Use
/goal make all tests pass
That's it. When opencode stops before the goal is done, it gets nudged to keep going. When the goal is done, it stops.
| Command | What it does |
|---|---|
/goal <text> |
Set a goal and start |
/goal |
Show the goal |
/goal pause |
Stop nudging, keep the goal |
/goal resume |
Start nudging again |
/goal clear |
Drop the goal |
Good to know:
- It doesn't nudge while subagents are running.
- While a command runs, it nudges at most once every
maxShellMinutes, because opencode wakes itself up when the command ends. The plugin can't tell a command opencode waits on from one left running on purpose (like a dev server), so it doesn't stay quiet forever. - Press Esc to stop it. It picks up again when you write a message.
- If opencode ignores 5 nudges in a row, the goal pauses. Use
/goal resume. - Goals survive a restart of opencode.
Settings (optional)
{
"plugins": [
{
"package": "opencode-tiny-goal",
"options": { "maxUnansweredReminders": 5, "maxWaitMinutes": 30, "maxShellMinutes": 5 }
}
]
}
| Option | Default | Meaning |
|---|---|---|
maxUnansweredReminders |
5 | Ignored nudges before the goal pauses |
maxWaitMinutes |
30 | Longest opencode can ask to be left alone |
maxShellMinutes |
5 | Time between nudges while a command runs |
Issues
opencode 2.x plugins are new, so an opencode update may break this. If it does, open an issue.
License
Similar plugins
Goal
@prevalentware/opencode-goal-plugin
OpenCode goal plugin that adds Codex-style long-running goal mode, /goal commands, persistence, and TUI status for AI coding agents.
Goal
opencode-goal-plugin
Durable, guarded goal workflows for OpenCode.
Loopd
@bojackduy/opencode-loopd
Codex-inspired background goal engine for OpenCode — autonomous subagents, engine-driven loop, child worker sessions and modal TUI dashboard. Like Claude Code loop for OpenCode.