Repository navigation
Releases
v1.0.4
[1.0.4] - 2026-09-28
Added
- Weekly CI job (
compat.yml) guarding host compatibility: floats
@opencode/pluginto the latest 2.x and re-runs typecheck + tests, and
boots a real isolated OpenCode server (scripts/live-smoke.sh) asserting
/goalregisters — drift is caught before users hit it. Manual trigger:
gh workflow run compat.yml. CHANGELOG.md(this file, shipped in the npm package),CONTRIBUTING.md,
and issue/PR templates.- Demo GIF in the README, reproducible via
vhs scripts/demo.tapeagainst a
throwaway environment (scripts/demo-env.sh). - GitHub releases now take their notes from this file's matching section.
Changed
- Development toolchain upgraded to TypeScript 7 (
tsc7.0.2, native port);
typecheck and tests pass with zero source changes. No runtime impact. - CI uses
actions/checkout@v7.
v1.0.3
Goal-state check before evidence/reason gating: goal_complete, goal_block, and their slash-command twins now report the goal's actual state (terminal, absent, paused) instead of demanding evidence when there's nothing to complete. README audit: documented continuationText, command aliases (status/done/blocked/tasks/log, --cap N, bare /goal <objective>), and the todo task status.
v1.0.2 — widget works from npm installs
[1.0.2] - 2026-09-25
Fixed
- The TUI widget now ships pre-compiled as
dist/tui.js, so npm installs
load the sidebar widget too (issue #3: the host's JSX transform skips
.tsxundernode_modules).
v1.0.1 — installs from npm
Fixes
- npm install now resolves. v1.0.0 failed inside OpenCode's plugin installer (
NpmInstallFailedError: npm auto-installs peerDependencies, and oursolid-js ^1.9.15peer collided with@opentui/solid's pinned1.9.12). Host-provided TUI peers are now marked optional viapeerDependenciesMeta, and the solid-js floor matches what the ecosystem ships.
Install
// ~/.config/opencode/opencode.jsonc — no clone needed
{ "plugins": ["opencode2-goals"] }opencode2-goals@1.0.0 is deprecated on npm; install @latest.
Known issue
The sidebar widget does not yet load from the npm tarball — point cli.json at a local checkout for the TUI entry until issue #3 is resolved. The server plugin (the entire goal loop) is unaffected.
v1.0.0 — the goal loop is out
First public release. A durable, session-scoped goal loop for OpenCode v2, in the public domain.
What you get
/goalcommand surface —set | view | pause | resume | clear | complete | block | historyplustasksubcommands. Safe by default: 10-turn / 100k-token caps unless you pass--turns/--tokensor explicitly--unbounded.- Evidence-gated completion —
goal_completeonly accepts concrete, transcript-grounded evidence (path, number, test result, command output). Weak claims are rejected and the goal stays active. - Model-callable tools —
goal_set(refuses to clobber a live goal),goal_complete,goal_block,goal_clear(only on a transcript-grounded quote of your request — the model can't erase its tracks),goal_add_task/goal_update_task, and read-onlygoal_history. - Event-driven continuation — objective re-injected into every agent-loop call; exactly one continuation per idle boundary; stall suppression when a turn makes no tool call; distinct
budget_limitedoutcome when caps are hit. - Unattended permission sandbox — in-scope file paths auto-allowed, out-of-scope denied with a steer to
goal_block; configured denies are never widened. - Durable history — terminal and superseded goals are archived per session;
/goal historyrenders them newest-first. - Live sidebar widget — three sections: objective, aligned counter grid (
Status/Turns/Tokens/Tasks+ task progress bar), task list. Legible in dark and light themes.
Install (local directory — nothing on npm)
git clone https://github.com/wukrit/opencode2-goals.git ~/Projects/opencode2-goalsThen add { "package": "/Users/you/Projects/opencode2-goals" } to plugins in ~/.config/opencode/opencode.jsonc (and cli.json for the widget), followed by opencode api post /api/location/reload. Full docs in the README.
Known limitations (honest by design)
- Evidence gating is a heuristic, not semantic verification.
- Two loaded locations sharing one project id can race (no atomic claim in plugin storage) — keep locations on distinct projects, single server process.
- Non-path permission prompts (shell/URL) remain manual.
Requires OpenCode 2.x (live-verified on 2.0.16) and a local-directory plugin load. License: The Unlicense (public domain).