feat(opencode): add /goal plugin for autonomous task completion by NathanKong76 · Pull Request #28610 · anomalyco/opencode

NathanKong76 · 2026-05-21T08:15:34Z

Summary

A built-in plugin that enables multi-turn autonomous goal execution via /goal command. Zero core changes — all business logic in the plugin, command registration via existing skill system.

create_goal / update_goal / get_goal tools via Hooks.tool
/goal pause / resume / clear via command.execute.before
Idle-event continuation loop via client.promptAsync()
Storage: .opencode/goals.json per directory (atomic write)

Closes #27167

Testing

bun test test/plugin/goal.test.ts: 18/18 pass (storage, logic, formatting)
bun test test/plugin/goal.integration.test.ts: 16/16 pass (all hooks via mock PluginInput)
bun typecheck: 0 errors
No regression in existing tests

github-actions · 2026-05-21T08:18:00Z

Thanks for updating your PR! It now meets our contributing guidelines. 👍

Copilot

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Introduces an experimental “goals” capability that lets a session persist an objective, continue autonomously across turns, and update goal status via new tools and a /goal command.

Changes:

Added goal session storage + service layer and wired it into the app/runtime layers.
Introduced create_goal / update_goal tools and a new /goal command template.
Extended the session prompt loop to optionally auto-continue when a goal is active.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 15 comments.

Show a summary per file

File	Description
packages/opencode/src/tool/registry.ts	Registers goal tools and provides the goal service layer.
packages/opencode/src/tool/goal.ts	Implements `create_goal` and `update_goal` tools.
packages/opencode/src/session/session.sql.ts	Adds `GoalStatus` and a new `goal` SQLite table.
packages/opencode/src/session/prompt.ts	Adds experimental auto-continue behavior based on active goals.
packages/opencode/src/session/goal.ts	New `SessionGoal` service for CRUD + iteration/token tracking.
packages/opencode/src/effect/app-runtime.ts	Provides `SessionGoal` layer at the app level.
packages/opencode/src/config/config.ts	Adds `experimental.goals` config flag.
packages/opencode/src/command/template/goal.txt	Adds `/goal` command prompt template.
packages/opencode/src/command/index.ts	Registers `/goal` command when `experimental.goals` is enabled.
packages/core/src/session-message-updater.ts	Adds no-op handlers for new goal events.
packages/core/src/session-event.ts	Defines new goal-related session events and includes them in the union.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

+          if (outcome === "break") {
+            const goalSvc = yield* SessionGoal.Service
+            const configSvc = yield* Config.Service
+            const cfg = yield* configSvc.get()
+            const goalsEnabled = cfg.experimental?.goals === true
+            if (goalsEnabled) {
+              const goal = yield* goalSvc.get(sessionID)
+              if (goal && goalSvc.isGoalContinueNeeded(goal)) {
+                yield* goalSvc.incrementIteration(sessionID)
+                const updatedGoal = yield* goalSvc.get(sessionID)
+                if (updatedGoal && goalSvc.isGoalContinueNeeded(updatedGoal)) {
+                  const contPrompt = updatedGoal.status === "budget_limited"
+                    ? goalSvc.getBudgetLimitPrompt(updatedGoal)
+                    : goalSvc.getContinuationPrompt(updatedGoal)
+                  const msgId = MessageID.ascending()


+    })
+
+    const isGoalContinueNeeded: Interface["isGoalContinueNeeded"] = (state: GoalState) => {
+      return state.status === "active"


@@ -1237,7 +1238,7 @@ export const layer = Layer.effect(
      throw new Error("Impossible")
    })

-    const runLoop: (sessionID: SessionID) => Effect.Effect<MessageV2.WithParts> = Effect.fn("SessionPrompt.run")(
+    const runLoop: (sessionID: SessionID) => Effect.Effect<MessageV2.WithParts, never, SessionGoal.Service | Config.Service> = Effect.fn("SessionPrompt.run")(


@@ -1485,7 +1523,7 @@ export const layer = Layer.effect(
    const loop: (input: LoopInput) => Effect.Effect<MessageV2.WithParts> = Effect.fn("SessionPrompt.loop")(function* (
      input: LoopInput,
    ) {
-      return yield* state.ensureRunning(input.sessionID, lastAssistant(input.sessionID), runLoop(input.sessionID))
+      return yield* state.ensureRunning(input.sessionID, lastAssistant(input.sessionID), runLoop(input.sessionID) as Effect.Effect<MessageV2.WithParts>)


+const UpdateGoalParams = Schema.Struct({
+  status: Schema.String.annotate({
+    description: 'New status: "complete" (goal achieved), "blocked" (cannot proceed)',
+  }),
+})


@@ -0,0 +1,230 @@
+import { Effect, Layer, Context, Schema } from "effect"


+import * as Log from "@opencode-ai/core/util/log"
+
+const DEFAULT_MAX_ITERATIONS = 50
+const log = Log.create({ service: "session.goal" })


+  timeUpdated: number
+}
+
+export class GoalNotFoundError extends Error {


+  }
+}
+
+export class GoalAlreadyExistsError extends Error {


+    "session.next.goal.set": () => {},
+    "session.next.goal.updated": () => {},
+    "session.next.goal.cleared": () => {},
+    "session.next.goal.completed": () => {},


NathanKong76 · 2026-05-27T02:35:42Z

Rewritten as a plugin per @aiden Cline feedback — zero core code changes, just 2 files.

Architecture

Tools: create_goal / update_goal / get_goal registered via Hooks.tool
Commands: /goal pause|resume|clear and --token-budget handled via Hooks["command.execute.before"]
Continuation: subscribes to session.status idle event via Hooks.event, injects <system-reminder> prompt via client.prompt() to trigger next LLM turn
Storage: .opencode/goals.json (single file, atomic tmp+rename write)

Design

No SQLite migration, no core schema changes
<system-reminder> tags keep continuation prompts invisible in chat
30s client.prompt() timeout + inFlight set prevents duplicate continuations
Budget uses iteration×4000 token estimate

Open to feedback — happy to adjust anything. If this pattern works, future goal features (time limits, subtask goals, etc.) can be added to the plugin without touching core.

github-actions · 2026-05-27T03:24:35Z

Thanks for updating your PR! It now meets our contributing guidelines. 👍

LeandroBenitez1998 · 2026-05-27T04:59:48Z

you are genius !

github-actions · 2026-05-28T09:29:18Z

This PR doesn't fully meet our contributing guidelines and PR template.

What needs to be fixed:

PR description is missing required template sections. Please use the PR template.

Please edit this PR description to address the above within 2 hours, or it will be automatically closed.

If you believe this was flagged incorrectly, please let a maintainer know.

github-actions · 2026-05-28T12:10:23Z

This pull request has been automatically closed because it was not updated to meet our contributing guidelines within the 2-hour window.

Feel free to open a new pull request that follows our guidelines.

Copilot AI review requested due to automatic review settings May 21, 2026 08:15

github-actions Bot added needs:compliance This means the issue will auto-close after 2 hours. and removed needs:compliance This means the issue will auto-close after 2 hours. labels May 21, 2026

Copilot AI reviewed May 21, 2026

View reviewed changes

NathanKong76 force-pushed the feat/native-goal-command branch 3 times, most recently from 3d912fc to 33076c5 Compare May 21, 2026 13:45

NathanKong76 mentioned this pull request May 27, 2026

[FEATURE]: Add native session goals with /goal #27167

Closed

1 task done

NathanKong76 force-pushed the feat/native-goal-command branch from 4728f09 to b2c696b Compare May 27, 2026 02:31

github-actions Bot added the needs:compliance This means the issue will auto-close after 2 hours. label May 27, 2026

NathanKong76 changed the title ~~feat: add native /goal command for autonomous task completion~~ feat: add /goal plugin for autonomous task completion May 27, 2026

github-actions Bot mentioned this pull request May 27, 2026

📊 AI CLI 工具社区动态日报 2026-05-27 ivanweng2077/big_model_radar#96

Open

NathanKong76 force-pushed the feat/native-goal-command branch 3 times, most recently from 0030ef4 to 1268d72 Compare May 27, 2026 03:06

github-actions Bot removed the needs:compliance This means the issue will auto-close after 2 hours. label May 27, 2026

NathanKong76 force-pushed the feat/native-goal-command branch from 1268d72 to 05c7a21 Compare May 27, 2026 14:30

NathanKong76 requested a review from adamdotdevin as a code owner May 27, 2026 14:30

NathanKong76 force-pushed the feat/native-goal-command branch 2 times, most recently from d11ead8 to 6b656b6 Compare May 28, 2026 04:09

github-actions Bot added the needs:compliance This means the issue will auto-close after 2 hours. label May 28, 2026

NathanKong76 changed the title ~~feat: add /goal plugin for autonomous task completion~~ feat(opencode): add /goal plugin for autonomous task completion May 28, 2026

NathanKong76 force-pushed the feat/native-goal-command branch 2 times, most recently from 26c7fc1 to da8a52c Compare May 28, 2026 09:39

feat(opencode): add /goal plugin for autonomous task completion

d11f33b

NathanKong76 force-pushed the feat/native-goal-command branch from da8a52c to d11f33b Compare May 28, 2026 09:45

github-actions Bot mentioned this pull request May 28, 2026

feat(opencode): add /goal command #29722

Closed

Merge branch 'dev' into feat/native-goal-command

af2107d

github-actions Bot removed the needs:compliance This means the issue will auto-close after 2 hours. label May 28, 2026

github-actions Bot closed this May 28, 2026

charleneleong-ai mentioned this pull request Aug 31, 2026

feat(plugin): add goal-loop example plugin #46328

Closed

3 of 6 tasks

Navigation Menu

Repository navigation

feat(opencode): add /goal plugin for autonomous task completion - #28610

feat(opencode): add /goal plugin for autonomous task completion#28610
NathanKong76 wants to merge 2 commits into
anomalyco:devfrom
NathanKong76:feat/native-goal-command

NathanKong76 commented May 21, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented May 21, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

NathanKong76 commented May 27, 2026

Uh oh!

github-actions Bot commented May 27, 2026

Uh oh!

LeandroBenitez1998 commented May 27, 2026

Uh oh!

github-actions Bot commented May 28, 2026

Uh oh!

github-actions Bot commented May 28, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		@@ -0,0 +1,230 @@
		import { Effect, Layer, Context, Schema } from "effect"

Conversation

NathanKong76 commented May 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Testing

Uh oh!

github-actions Bot commented May 21, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

NathanKong76 commented May 27, 2026

Architecture

Design

Uh oh!

github-actions Bot commented May 27, 2026

Uh oh!

LeandroBenitez1998 commented May 27, 2026

Uh oh!

github-actions Bot commented May 28, 2026

Uh oh!

github-actions Bot commented May 28, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

NathanKong76 commented May 21, 2026 •

edited

Loading