II.
HookSurface overview
Reference · livehook-surface:pre-tool-use
PreToolUse (canonical) overview
The v6 canonical pre-tool-use hook. Native vendor surfaces canonicalize to this surface so cross-product policies and plugins can target a single name.
Attributes
eventName
PreToolUse (canonical)
displayName
PreToolUse (canonical)
kind
canonical
direction
pre
blocking
true
family
shell-hook
payloadSchema
type
object
required
- tool_name
- tool_input
- session_id
- transcript_path
properties
tool_name
type
string
description
Name of the tool about to be invoked.
tool_input
type
object
description
Tool-specific input arguments.
session_id
type
string
transcript_path
type
string
cwd
type
string
description
The v6 canonical pre-tool-use hook. Native vendor surfaces
canonicalize to this surface so cross-product policies and
plugins can target a single name.
Outgoing edges
None.
Incoming edges
canonicalized_to5
- hook-surface:claude.pre-tool-use·HookSurfacePreToolUse (Claude)
- hook-surface:codex.on-tool-call·HookSurfaceOnToolCall (Codex)
- hook-surface:cursor.pre-tool·HookSurfacepre_tool (Cursor)
- hook-surface:gemini.pre-prompt·HookSurfacepre_prompt (Gemini)
- hook-surface:gemini.tool-call-pre·HookSurfacetool_call_pre (Gemini)
exposes1
- agent-runtime-impl:claude-code.runtime@1.x·AgentRuntimeImplClaude Code Runtime (1.x)
fires_hook3
- agent-core-impl:a5c.core@current·AgentCoreImpla5c Unified Core (current) — unified agent loop
- agent-core-impl:claude-agent-sdk.core@current·AgentCoreImplClaude Agent SDK Core (current)
- agent-core-impl:claude-code.core@1.x·AgentCoreImplClaude Code Core (1.x)
maps_hook12
- hook-mapping:pre-tool-use-antigravity·HookMapping
- hook-mapping:pre-tool-use-opencode·HookMapping
- hook-mapping:pre-tool-use-pi·HookMapping
- hook-mapping:pre-tool-use-oh-my-pi·HookMapping
- hook-mapping:pre-tool-use-claude-code·HookMapping
- hook-mapping:pre-tool-use-codex·HookMapping
- hook-mapping:pre-tool-use-gemini·HookMapping
- hook-mapping:pre-tool-use-cursor·HookMapping
- hook-mapping:tool-before-gemini·HookMapping
- hook-mapping:tool-before-copilot·HookMapping
- hook-mapping:pre-tool-use-codex-stdin·HookMapping
- hook-mapping:plugin-tool-before-openclaw·HookMapping