Software Development

Diagnosing Hooks

Use to diagnose and fix ZCode hook configuration problems in the ZCode client. Applies when a hook does not trigger, an event name is wrong, a matcher does not match a tool name, a script is not executable, template variables are not expanded, a timeout unit is mistaken (seconds versus milliseconds), the command and process field styles are mixed, a hook's JSON output fails validation, a hook blocks the session unexpectedly, or configuration-file hooks are not enabled. Provides configuration sources, the hooks.json schema, how to inspect hooks in the client, and a step-by-step localization and repair workflow.

Publisher / source

zai-org/ZCode (found on the CSV list)

Upstream record

zai-org/ZCode

Version

Version 3

Published

2026-11-12

Publication review

Approved for publication · recorded passed scan 2026-11-12

Content fingerprint

a988394e7b46040770d6e89c1080cf0bff7440065257cb34dcd91c31bc4f1d86