Enum HookAction 

pub enum HookAction {
    Command {
        command: String,
    },
    McpTool {
        server: String,
        tool: String,
        args: Value,
    },
}

The action a hook executes when triggered.

Hooks either run a shell command or invoke an MCP server tool directly.

Examples

# Shell command hook
[[hooks.cwd_changed]]
type = "command"
command = "echo $ZEPH_NEW_CWD"
timeout_secs = 10

# MCP tool hook
[[hooks.permission_denied]]
type = "mcp_tool"
server = "policy-server"
tool = "audit_denied"
[hooks.permission_denied.args]
severity = "high"

Variants

Command

Execute a shell command via sh -c.

Fields

command: String

The shell command to run.

McpTool

Invoke an MCP server tool directly without spawning a subprocess.

Fields

server: String

The MCP server ID as declared in [[mcp.servers]].

tool: String

The tool name to call on that server.

args: Value

Optional JSON arguments passed to the tool. Defaults to {}.

Trait Implementations

impl Clone for HookAction

fn clone(&self) -> HookAction

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HookAction

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HookAction

fn deserialize<__D>( __deserializer: __D, ) -> Result<HookAction, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HookAction

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.