Hook reference
This page summarizes the hook events and executor types supported by Kheish.Hook events
Important hook event families include:- tool lifecycle:
pre_tool_use,post_tool_use,post_tool_use_failure - permission lifecycle:
permission_request,permission_denied - session lifecycle:
setup,session_start,session_end,user_prompt_submit,stop,stop_failure - subagent lifecycle:
subagent_start,subagent_stop,teammate_idle - task lifecycle:
task_created,task_completed - compaction:
pre_compact,post_compact - file and runtime changes:
file_changed,cwd_changed,instructions_loaded,config_change - auxiliary events:
elicitation,elicitation_result,notification,worktree_create,worktree_remove
Executor types
Kheish supports these hook executors:commandhttppromptagentcallback
Hook outcome model
Hook handlers can return structured effects such as:continue_executionstop_reasondecisionpermissionupdated_inputupdated_outputupdated_permissionsadditional_contextsinitial_user_messagewatch_pathsretry