Hook payloads

Claude Code invokes each hook command with a JSON object on stdin. gitvow reads these fields:

Field	Used by	Meaning
`session_id`	all	the session identifier
`transcript_path`	PostToolUse, Stop	path to the JSONL transcript Claude Code keeps locally
`cwd`	all	the repository being worked on
`hook_event_name`	all	`SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop`
`tool_name`	PreToolUse, PostToolUse	e.g. `Bash`, `Edit`, `mcp__server__tool`
`tool_input`	PreToolUse, PostToolUse	e.g. `{"command": "..."}` or `{"file_path": "..."}`
`prompt`	UserPromptSubmit	the person’s message; only the first line of the session’s first message is kept, redacted, as the intent; the message itself is never stored
`permission_mode`	PreToolUse	Claude Code’s mode; in the prompting modes a confirm is answered as `permissionDecision: ask`

PostToolUse on an editing tool records the blob id of the written file for attribution and takes a working-tree snapshot; on a git commit it writes the session note. UserPromptSubmit records the intent once per session and prints nothing. Output contract: exit 0 allows the call; exit 2 blocks it and Claude Code feeds stderr back to the model as the reason. gitvow never writes to stdout from a hook.

Settings entries

gitvow install merges these into settings.json:

{"hooks": {
  "SessionStart": [{"hooks": [{"type": "command", "command": "gitvow hook SessionStart"}]}],
  "UserPromptSubmit": [{"hooks": [{"type": "command", "command": "gitvow hook UserPromptSubmit"}]}],
  "PreToolUse":   [{"matcher": "Bash|Edit|Write|MultiEdit|NotebookEdit|mcp__.*", "hooks": [{"type": "command", "command": "gitvow hook PreToolUse"}]}],
  "PostToolUse":  [{"matcher": "Bash|Edit|Write|MultiEdit|NotebookEdit", "hooks": [{"type": "command", "command": "gitvow hook PostToolUse"}]}],
  "Stop":         [{"hooks": [{"type": "command", "command": "gitvow hook Stop"}]}]
}}

Entries are recognised by the gitvow hook prefix, so install is idempotent and uninstall removes only these.

Other agents

Codex CLI, Gemini CLI and Cursor are supported through adapters that translate their payloads into this shape; see Adapter reference.

Start

Concepts

Guides

Reference

Project

Settings entries

Other agents

​Settings entries

​Other agents

Settings entries

Other agents