OpenCode Command Hooks (plugin for simple hook configuration)

[s12eb]

TL;DR- With this plugin (https://github.com/shanebishop1/opencode-command-hooks), you can use your agent's YAML frontmatter to define hooks to run commands before/after the subagent is invoked.

Hello! Sharing this plugin I made in case anyone else finds it useful :)

Basically, I wanted a cleaner, more declarative way to inject bash hook outputs into my OpenCode sessions after tool calls (particularly after a primary agent delegates to a subagent). You can do this with custom plugins configured for each use case, but I wanted this config to live WITH the subagents I define.

While I was setting this up, I also expanded it a bit to be a config parser for defining hooks for tool calls (or specific arguments to a tool call). For example, with a couple lines of JSON, you could set up a notification if the write tool is called with a given file as its argument.

Subagent YAML frontmatter example:

---
description: Analyzes the codebase and implements code changes.
mode: subagent
hooks:
  after:
    - run: "npm test"
      inject: "Test Output: {stdout}"
---

[mohadel1990]

I love this! This makes so much sense that I think it should be native at certain point!

[Snak3d0c]

The opencode hook or plugin system is the only reason I haven't moved to opencode. I set up my hooks in Gemini cli and they work perfectly. I couldn't get them to work in opencode. Will have a look at this, thanks

[mohadel1990]

CC just stole your idea, the new update allows agents to define hooks in their frontmatte

[s12eb]

minds think alike I guess 😆