Struct ClaudeCodeHook 

pub struct ClaudeCodeHook { /* private fields */ }

Claude Code hook using Skills lifecycle

Installation:

1. Creates Claude Code Skill at ~/.claude/skills/nexus-memory/SKILL.md
2. Skill auto-triggers on session_end, checkpoint, completion
3. Skill calls MCP tool to store memory

Lifecycle support:

• session_start: Via settings.json SessionStart hook entry
• session_end: Via skill (on_session_end trigger)
• checkpoint: Via skill (on_checkpoint trigger)
• error: Via skill (on_error trigger)
• compact: Via skill (on_completion trigger)

Implementations

impl ClaudeCodeHook

pub const SKILL_NAME: &'static str = "nexus-memory-extraction"

Skill name

pub const CONFIG_DIR: &'static str = ".claude"

Config directory

pub const SKILLS_DIR: &'static str = "skills"

Skills subdirectory

pub fn new() -> Self

Create a new Claude Code hook

Trait Implementations

impl AgentHook for ClaudeCodeHook

fn install_session_start_hook<'life0, 'async_trait>( &'life0 mut self, callback: SessionEndCallback, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Install a SessionStart hook via Claude Code’s settings.json.

Claude Code natively supports the SessionStart hook event type, which fires when a new Claude Code session begins. This writes a hook entry that invokes nexus session start --agent claude-code.

fn install_checkpoint_hook<'life0, 'async_trait>( &'life0 mut self, callback: SessionEndCallback, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Checkpoint hooks are supported via the installed skill’s on_checkpoint trigger.

fn install_compact_hook<'life0, 'async_trait>( &'life0 mut self, callback: SessionEndCallback, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Compact hooks are supported via the installed skill’s on_completion trigger.

fn install_error_hook<'life0, 'async_trait>( &'life0 mut self, callback: SessionEndCallback, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Error hooks are supported via the installed skill’s on_error trigger.

fn agent_type(&self) -> &str

Get the agent type this hook handles

fn install_session_end_hook<'life0, 'async_trait>( &'life0 mut self, callback: SessionEndCallback, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Install the session end hook

fn detect_session_activity<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<SessionActivity>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Detect if the agent session is currently active

fn extract_session_context<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<SessionContext>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Extract session context from the agent

fn is_hook_installed(&self) -> bool

Optional: Check if native hook is installed

fn reliability_score(&self) -> f32

Optional: Get hook reliability score (0.0-1.0)

fn lifecycle_capabilities(&self) -> LifecycleCapabilities

Report which lifecycle events this agent hook supports.

fn support_tier(&self) -> SupportTier

Report the support tier for this agent hook.

fn uninstall_hooks<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Optional: Uninstall all hooks

impl Default for ClaudeCodeHook

fn default() -> Self

Returns the “default value” for a type.