Appearance
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 <workspace>/.claude/settings.local.json, nên chúng chỉ chạy khi session mở ở gốc workspace; ~/.claude/settings.json không còn hook nào của kit. 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
| Event | Matcher | Lệnh | Mục đích | Runtime |
|---|---|---|---|---|
| SessionStart | — | zenify 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 | Claude, Codex |
| SessionStart | — | zenify hooks-run git-state | In báo cáo trạng thái git của workspace vào context đầu phiên | Claude, Codex |
| SessionStart | — | zenify hooks-run wt-report | In một dòng liệt kê worktree đã merge/rác mà wt sweep --all sẽ dọn | Claude, Codex |
| SessionStart | — | zenify hooks-run tmp-check | Cảnh báo khi thư mục tạm của user bị rò rỉ tới ≥ 50.000 mục (macOS có thể treo khi khởi động) hoặc máy chạy liên tục ≥ 7 ngày | Claude, Codex |
| Stop | — | zenify hooks-run docs-sync | Đồng bộ knowledge store qua git (status → pull --rebase → push), fail-open | Claude, Codex |
| Stop | — | zenify hooks-run git-state-stop | Báo trạng thái git dạng cảnh báo đứng (systemMessage) khi phiên dừng | Claude, Codex |
| PreToolUse | Task|Agent | zenify hooks-run observe-count | Đếm số lần dispatch subagent, cảnh báo khi vượt soft-cap | Claude, Codex |
| PostToolUse | Task|Agent|Bash|WebFetch|WebSearch|Read | zenify hooks-run observe-meter | Ghi nhận việc dùng tool để đo usage | Claude, Codex |
| PreToolUse | Read | zenify hooks-run read-guard | Chặn Read file quá lớn (text > 200 KB không có offset+limit, PDF không có pages, ảnh > 300 KB) trước khi kết quả vào context | Claude |
| PreToolUse | mcp__zenify-plane__.* | zenify hooks-run plane-guard | Plane MCP: action đọc chạy thẳng, action ghi luôn hỏi người dùng (kể cả chế độ bypass) | Claude |
| PreToolUse | Write|Edit|NotebookEdit | zenify hooks-run write-guard | Chặn Write/Edit ra ngoài quy ước thư mục workspace (root ngoài allowlist, file ngay dưới docs/, docs/<tên lạ>) và chỉ chỗ đúng | Claude |
| PreToolUse | Bash | zenify git-guard (cài bằng zenify guard install) | Chặn commit/push/merge vào nhánh deploy | Claude, Codex |