II.
HookSurface overview
Reference · livehook-surface:claude.pre-tool-use
PreToolUse (Claude) overview
Claude Code's pre-tool-use hook. Fired before every tool invocation. A non-zero exit code from the configured handler aborts the tool call.
Attributes
eventName
PreToolUse (Claude)
displayName
PreToolUse (Claude)
kind
native
originVendor
Anthropic
direction
pre
blocking
true
family
shell-hook
payloadSchema
type
object
required
- tool_name
- tool_input
- session_id
- transcript_path
properties
tool_name
type
string
tool_input
type
object
session_id
type
string
transcript_path
type
string
description
Claude Code's pre-tool-use hook. Fired before every tool
invocation. A non-zero exit code from the configured handler
aborts the tool call.
Outgoing edges
canonicalized_to1
- hook-surface:pre-tool-use·HookSurfacePreToolUse (canonical)
emits_hook1
- agentVersion:claude:ge-0-0-0·AgentVersionClaude Code
Incoming edges
diagnoses_hook_surface2
- hook-merge-diagnostic:precedence-resolved·HookMergeDiagnostic
- hook-merge-diagnostic:conflict-blocked·HookMergeDiagnostic
exposes1
- agent-runtime-impl:claude-code.runtime@1.x·AgentRuntimeImplClaude Code Runtime (1.x)
maps_hook1
- hook-mapping:claude-pre-tool-use-native·HookMapping