Repository navigation
[FEATURE]: Add expanded hook events to the plugin system to enable more powerful plugin capabilities. #21075
Closed as not planned
Description
Feature hasn't been suggested before.
- I have verified this feature I'm about to request hasn't been suggested before.
Describe the enhancement you want to request
Problem
The current OpenCode plugin system lacks many useful hook events that would allow plugins to intercept and customize agent behavior at key points. This makes it difficult to build powerful plugins that can:
- Monitor session lifecycle (start/end)
- Intercept tool execution (modify arguments, log results)
- React to agent stopping events
- Handle permission requests
- Participate in session compaction
Proposed Solution
Expand the hook events system with new lifecycle hooks:
session.start/session.end- Session lifecyclestop- Agent stop eventpreToolUse/postToolUse- Tool execution interceptionpermission.request- Permission request eventpreCompact/postCompact- Session compaction events
All hooks include functional triggers in the codebase.
Files Changed
packages/plugin/src/index.ts- Hook type definitionspackages/opencode/src/session/index.ts- session.start/end triggerspackages/opencode/src/session/processor.ts- stop triggerpackages/opencode/src/session/prompt.ts- preToolUse/postToolUse triggerspackages/opencode/src/session/compaction.ts- preCompact/postCompact triggerspackages/opencode/src/permission/index.ts- permission.request trigger
Metadata
Metadata
Assignees
Labels
No labels
Activity
github-actions commentedon Apr 5, 2026
This issue doesn't fully meet our contributing guidelines.
What needs to be fixed:
[FEATURE]:— please rename to:[FEATURE]: Add expanded hook events to the plugin system to enable more powerful plugin capabilitiesPlease edit this issue to address the above within 2 hours, or it will be automatically closed.
This issue might be a duplicate of existing issues. Please check:
preToolUse/postToolUse/stophookssession.start/session.endpreCompact/postCompactstopagent eventpermission.requestThis request appears to bundle several hooks that have already been individually requested. Please review the above issues and consider whether this should be closed in favor of the existing ones (or link to them).
If you believe this was flagged incorrectly, please let a maintainer know.
[-]Add expanded hook events to the plugin system to enable more powerful plugin capabilities.[/-][+][Add expanded hook events to the plugin system to enable more powerful plugin capabilities.[/+][-][Add expanded hook events to the plugin system to enable more powerful plugin capabilities.[/-][+][FEAUTURE]: Add expanded hook events to the plugin system to enable more powerful plugin capabilities.[/+][-][FEAUTURE]: Add expanded hook events to the plugin system to enable more powerful plugin capabilities.[/-][+][FEATURE]: Add expanded hook events to the plugin system to enable more powerful plugin capabilities.[/+]github-actions commentedon Apr 5, 2026
Thanks for updating the issue! The title now correctly starts with
[FEATURE]:and the issue meets our contributing guidelines. We appreciate the detailed proposal.xbjpku commentedon Apr 22, 2026
This is partially addressed by #23650 — a minimal
session.turn.completedevent (+9 lines, 2 files). It enables post-turn plugins like ScarletWitch, a filesystem sandbox that shows a COW review dialog after each turn. Happy to adjust based on feedback.github-actions commentedon Jul 6, 2026
To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.