Skip to content
Development
Hook

Hooks

What woz runs automatically, and when. A hook is a command Claude Code fires at a fixed moment, without you asking for it.

Install
$ npx -y skills add WithWoz/wozcode-plugin --agent claude-code

Ships with woz. Installing the plugin gets these hooks.

What fires, and when

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.

  • Runs session-hook.js.

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.

  • Runs session-hook.js.

PreToolUse

  • Runs session-hook.js.

PostToolUse

  • Runs reviewer-hook.js.

SubagentStop

  • Runs session-telemetry-hook.js.

Stop

  • Runs session-telemetry-hook.js.

StopFailure

  • Runs session-hook.js.

PreCompact

  • Runs session-telemetry-hook.js.

PostCompact

  • Runs session-telemetry-hook.js.
Read hooks/hooks.json
Ships withwoz

Smarter tools for Claude Code that reduce token usage and cost. Replaces built-in file tools with optimized alternatives — fewer tokens per tool call means cheaper sessions that compound over time.

Get the whole plugin, auto-invoked
Stats
200
Stars
0
Views
24
Forks
Active
Maintenance
JavaScript
Language
11d ago
Last commit
4mo ago
Created

Repo: WithWoz/wozcode-plugin