Hooks
What claude-wave-plugin runs automatically, and when. A hook is a command Claude Code fires at a fixed moment, without you asking for it.
> /plugin marketplace add Harshvardhan86/claude-wave-plugin > /plugin install claude-wave-plugin@claude-wave-plugin
Ships with claude-wave-plugin. Installing the plugin gets these hooks.
What fires, and when
PreToolUse
- Matches
^Agent$"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/pre-agent.sh - Matches
^(Edit|Write|NotebookEdit|MultiEdit)$"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/pre-edit.sh - Matches
^Read$"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/pre-read.sh - Matches
^Bash$"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/pre-bash.sh - Matches
^Bash$"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/pre-commit-guard.sh - Matches
^Monitor$"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/pre-monitor.sh
PostToolUse
- Matches
^Agent$"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/post-agent.sh - Matches
^Bash$"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/post-bash.sh
SubagentStop
"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/subagent-stop.sh
PreCompact
"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/pre-compact.sh
SessionStart
Fires once when a session begins, and again after a context compaction. It is where a plugin sets up its environment, or restores state the compaction dropped.
- Matches
startup|resume|clear|compact"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/session-start.sh
Stop
"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/stop.sh
UserPromptSubmit
Fires before Claude sees each prompt you send. A plugin can use it to inject context, so the same instruction reaches the model every turn instead of only at session start.
"${CLAUDE_PLUGIN_ROOT}"/scripts/hooks/user-prompt.sh
In the plugin's words
How claude-wave-plugin describes its own hook set.
Wave hook enforcement: phase order and hand-off artifacts, per-role model routing, orchestrator-only editing/reading/bash in the main session, a commit-message guard, a token ledger and a scorecard pointer. Every command below is silent (exit 0, no output) whenever no wave is
Run Claude Code like an engineering org. Wave-based execution with dedicated sub-agents per phase, computed-style visual verification, no "tsc passes" lies.
Repo: Harshvardhan86/claude-wave-plugin