Hook Integration

SessionStart Hook: /opt/mcp-servers/shared/hooks/session_start_hook.py

Configured in: ~/.claude/settings.local.json

Matchers: startup | resume | compact

What it does: - Outputs hookSpecificOutput.additionalContext to Claude - Includes session ID and stable ID - Reminds to call workflow.init as first action - Writes environment variables to CLAUDE_ENV_FILE

Hook Output Format:

{
  "hookSpecificOutput": {
    "hookEventName": "SessionStart",
    "additionalContext": "NEXUS SESSION RESUME...\nREQUIRED: Call workflow.init"
  },
  "session": {"session_id": "...", "stable_id": "s_XXXX"}
}

See also: KB entry 656287d9 (Claude Code Hooks)