Plugins and Hooks

Plugins and Hooks

Plugin manifests live under:

.coop/projects/<project.id>/plugins/*.yml

Example console logger:

id: console-log
name: "Console Logger"
version: "1.0.0"
triggers:
  - event: task.transitioned
    action:
      type: console
      template: "Task {{ task.id }} moved to {{ event.to }} by {{ event.actor }}"

Example GitHub PR sync:

id: github-pr
name: "GitHub PR Sync"
version: "1.0.0"
triggers:
  - event: task.transitioned
    filter:
      to: [in_review]
    action:
      type: github_pr
      operation: create_or_update
  - event: task.transitioned
    filter:
      to: [done]
    action:
      type: github_pr
      operation: merge

Hooks are configured separately in project config under hooks.

Use plugin manifests for declarative integrations. Use hooks when you need a local script entrypoint tied to workspace lifecycle events.