II.
HookSurface overview
Reference · livehook-surface:claude.setup
Setup (Claude Code) overview
Fires only on `--init-only`, `-p --init`, or `-p --maintenance`. One-time initialization hook for CI / scripts / one-shot bootstrap. Has access to CLAUDE_ENV_FILE for environment persistence. Distinct from SessionStart which fires on every session.
Attributes
eventName
Setup (Claude Code)
displayName
Setup (Claude Code)
kind
native
originVendor
Anthropic
direction
pre
blocking
false
family
shell-hook
payloadSchema
type
object
required
- session_id
- transcript_path
- cwd
- hook_event_name
- trigger
properties
session_id
type
string
transcript_path
type
string
cwd
type
string
hook_event_name
type
string
const
Setup
trigger
type
string
enum
- init
- maintenance
description
Fires only on `--init-only`, `-p --init`, or `-p --maintenance`. One-time
initialization hook for CI / scripts / one-shot bootstrap. Has access to
CLAUDE_ENV_FILE for environment persistence. Distinct from SessionStart
which fires on every session.
Outgoing edges
None.
Incoming edges
exposes1
- agent-runtime-impl:claude-code.runtime@1.x·AgentRuntimeImplClaude Code Runtime (1.x)
maps_hook1
- hook-mapping:claude-setup·HookMapping