Quick answer
opencode hooks: what to know first
Nutze Hooks nur, wenn der genaue Zeitpunkt wichtig ist. Sie sind enge Guardrails rund um Tools, kein Ersatz für Skills, Commands, MCP, Berechtigungen oder CI.
Nutze Hooks nur, wenn der genaue Zeitpunkt wichtig ist. Sie sind enge Guardrails rund um Tools, kein Ersatz für Skills, Commands, MCP, Berechtigungen oder CI.
This page deliberately separates `opencode hooks` from the site's broader OpenCode Plugins guide. The plugins page explains when packaged extensions are worth installing. This page focuses on lifecycle behavior: event choice, scope, placement, examples, failure modes, testing, rollback, and how hooks interact with tools, skills, commands, MCP, and GitHub automation.
Related site guides: OpenCode Plugins, OpenCode Skills, OpenCode MCP, OpenCode session storage.
1. Wann Hooks sinnvoll sind
Nutze Hooks nur, wenn der genaue Zeitpunkt wichtig ist. Sie sind enge Guardrails rund um Tools, kein Ersatz für Skills, Commands, MCP, Berechtigungen oder CI.
Wenn der Bedarf nicht vom exakten Zeitpunkt abhängt, bleibt die Lösung besser in Skill, Command, Permission oder MCP. Ein Hook braucht eine klare Bedingung und ein sichtbares Ergebnis.
2. Wo Hooks liegen
Nutze Hooks nur, wenn der genaue Zeitpunkt wichtig ist. Sie sind enge Guardrails rund um Tools, kein Ersatz für Skills, Commands, MCP, Berechtigungen oder CI.
Repository-Regeln gehören ins Projekt, damit das Team sie prüfen kann. Persönliche Präferenzen sind global, npm-Pakete brauchen Quellen- und Versionsprüfung.
3. Das Event wählen
Nutze Hooks nur, wenn der genaue Zeitpunkt wichtig ist. Sie sind enge Guardrails rund um Tools, kein Ersatz für Skills, Commands, MCP, Berechtigungen oder CI.
Formuliere zuerst den Eventsatz: vor der Ausführung, nach dem Tool oder nach einer Dateiänderung. Wenn mehrere Aktionen enthalten sind, teile den Hook.
4. Sichere Beispiele und Risiken
Nutze Hooks nur, wenn der genaue Zeitpunkt wichtig ist. Sie sind enge Guardrails rund um Tools, kein Ersatz für Skills, Commands, MCP, Berechtigungen oder CI.
Sichere Beispiele warnen, normalisieren oder schreiben minimale Notizen. Vermeide Commits, Pushes, Secrets, Remote-Netzwerk und stille Änderungen in Hooks.
5. In einem Wegwerf-Repo testen
Nutze Hooks nur, wenn der genaue Zeitpunkt wichtig ist. Sie sind enge Guardrails rund um Tools, kein Ersatz für Skills, Commands, MCP, Berechtigungen oder CI.
Der Test nutzt ein kleines Repository, einen harmlosen Befehl, geprüfte Ausgabe und einen klaren Weg zum Deaktivieren.
6. Schichtweise debuggen
Nutze Hooks nur, wenn der genaue Zeitpunkt wichtig ist. Sie sind enge Guardrails rund um Tools, kein Ersatz für Skills, Commands, MCP, Berechtigungen oder CI.
Beim Debugging wird jeweils nur eine Schicht deaktiviert und dieselbe Aufgabe erneut ausgeführt. So trennst du Lifecycle-Code, Anweisungen, MCP und Provider.
7. Von GitHub und CI trennen
Nutze Hooks nur, wenn der genaue Zeitpunkt wichtig ist. Sie sind enge Guardrails rund um Tools, kein Ersatz für Skills, Commands, MCP, Berechtigungen oder CI.
GitHub- und CI-Automation gehört in explizite Workflows. Lokale Hooks unterstützen nur Guardrails während der OpenCode-Sitzung.
OpenCode hooks FAQ
Was sind OpenCode Hooks?
Lifecycle-Callbacks, die von Plugins zurückgegeben werden.
Sind Hooks dasselbe wie Plugins?
Nein. Das Plugin lädt und liefert Hooks.
Wo platziere ich Hooks?
Projektlokal für Repo-Regeln, global für persönliche Workflows.
Ersetzen sie Berechtigungen?
Nein. Berechtigungen regeln breite Policies.
Wie teste ich sie?
In einem Wegwerf-Repository mit kleiner Aufgabe und klarem Rollback.
Sources
Official OpenCode documentation and current SERP evidence were checked on 2026-07-23. Plugin APIs and event names can change, so verify exact code against the current docs before shipping a hook.