II.
HookSurface overview
Reference · livehook-surface:claude.file-changed
FileChanged (Claude Code) overview
Fires when a watched file changes on disk. Has access to CLAUDE_ENV_FILE for reactive environment management (direnv, nvm, etc.). Matcher accepts literal filenames (e.g. ".envrc|.env"); regex is NOT supported for this event.
Attributes
eventName
FileChanged (Claude Code)
displayName
FileChanged (Claude Code)
kind
native
originVendor
Anthropic
direction
post
blocking
false
family
observer
payloadSchema
type
object
required
- hook_event_name
- file_path
- change_type
properties
hook_event_name
type
string
const
FileChanged
file_path
type
string
change_type
type
string
enum
- created
- modified
- deleted
description
Fires when a watched file changes on disk. Has access to
CLAUDE_ENV_FILE for reactive environment management (direnv, nvm,
etc.). Matcher accepts literal filenames (e.g. ".envrc|.env"); regex
is NOT supported for this event.
Outgoing edges
None.
Incoming edges
exposes1
- agent-runtime-impl:claude-code.runtime@1.x·AgentRuntimeImplClaude Code Runtime (1.x)
maps_hook1
- hook-mapping:claude-file-changed·HookMapping