Skip to content

Hook

Các hook ZenifyKit nối vào Claude Code để tự động đồng bộ, báo cáo trạng thái, và đo mức dùng.

zenify up viết các hook dưới đây vào ~/.claude/settings.json. Mỗi hook chỉ là một lệnh dạng zenify hooks-run <id>, nên gỡ hay đọc lại cũng chỉ là một dòng cấu hình. Mọi hook đều fail-open: lỗi bên trong không chặn phiên làm việc của bạn. Các hook chỉ hoạt động khi phiên chạy bên trong một workspace ZenifyKit đã khởi tạo.

Bảng hook

EventMatcherLệnhMục đích
SessionStartzenify hooks-run session-startĐồng bộ knowledge store, ghi lại rules/workspace mới nhất, nhắc update, in digest bootstrap nếu máy chưa có sentinel discipline
SessionStartzenify hooks-run git-stateIn báo cáo trạng thái git của workspace vào context đầu phiên
SessionStartzenify hooks-run wt-reportIn một dòng liệt kê worktree đã merge/rác mà wt sweep --all sẽ dọn
Stopzenify hooks-run docs-syncĐồng bộ knowledge store qua git (status → pull --rebase → push), fail-open
Stopzenify hooks-run git-state-stopBáo trạng thái git dạng cảnh báo đứng (systemMessage) khi phiên dừng
PreToolUseTask|Agentzenify hooks-run observe-countĐếm số lần dispatch subagent, cảnh báo khi vượt soft-cap
PostToolUseTask|Agent|Bash|WebFetch|WebSearch|Readzenify hooks-run observe-meterGhi nhận việc dùng tool để đo usage
PreToolUseBashzenify git-guard (cài bằng zenify guard install)Chặn commit/push/merge vào nhánh deploy