Appearance
Lệnh CLI
Dùng phần này khi bạn đã biết mình cần kết quả gì và muốn tìm đúng lệnh zenify.
Mỗi lệnh có một trang riêng với cú pháp, cờ và ví dụ. Nội dung cú pháp và cờ lấy thẳng từ binary, nên luôn khớp với phiên bản bạn đang chạy. Kiểm tra phiên bản bằng zenify version.
Tìm lệnh theo việc cần làm
Tất cả lệnh
| Lệnh | Mô tả |
|---|---|
| zenify analyze | Kiểm tra cơ học một cặp spec và plan trước khi code: coverage FR, marker còn sót, cấu trúc Brief. |
| zenify await | Dừng một lượt chạy không người ở cổng cần người duyệt, ghi bản ghi await rồi thoát mã 8. |
| zenify await show | In lại bản ghi await theo id. |
| zenify broker | Nhóm lệnh làm việc với credential broker của zenify. |
| zenify broker headers | In header Authorization cho MCP http của Claude Code, dưới dạng một object JSON. |
| zenify broker token | In JWT của credential broker ra stdout, dùng cache và tự xin lại khi còn dưới 60 giây. |
| zenify browser | Điều khiển trình duyệt qua playwright-cli đã ghim, mỗi phiên một trình duyệt và một thư mục riêng, để znf:ui-verifier chạy song song. |
| zenify catalog | In danh mục dịch vụ giám sát (datasource Grafana, tên log, trace, metric) dưới dạng YAML. |
| zenify catalog drift | So danh mục với tên đang có thật trong Loki, Prometheus (7 ngày qua) và Tempo (72 giờ qua). |
| zenify config | Kéo cấu hình chung của team từ knowledge store vào workspace theo một chiều. |
| zenify cost | Cho biết token Claude Code đi đâu: context mỗi turn, phần subagent, model, skill và dấu hiệu lãng phí, đọc từ transcript local. |
| zenify data | Nhóm lệnh chạy script dữ liệu với credential DB do broker cấp, không để lộ giá trị trong output. |
| zenify data run | Chạy một lệnh với credential DB từ broker, che giá trị trong stdout và stderr, ghi thật phải dry-run trước. |
| zenify db-perf | Quét tĩnh một diff để tìm anti-pattern query DB, chia finding thành BLOCKING và ADVISORY. |
| zenify db-read | Đọc database dùng chung ở chế độ chỉ đọc, không bao giờ ghi và không in secret. |
| zenify docs | Nhóm lệnh cho docs layer: đồng bộ knowledge store và sinh trang tham chiếu. |
| zenify docs gen | Sinh các trang tham chiếu của website này từ binary, hoặc kiểm tra trang đã sinh còn khớp. |
| zenify docs sweep | Dọn knowledge store - xóa plan, handoff, reference đã hết giá trị và ghi header trạng thái cho spec; mặc định chỉ in kế hoạch. |
| zenify docs sync | Đồng bộ knowledge store với remote qua git và dựng lại view docs/ trong workspace. |
| zenify doctor | Kiểm tra sức khỏe môi trường ZenifyKit trên máy và báo từng mục đạt hay hỏng. |
| zenify down | Gỡ phần ZenifyKit đã cài vào máy và repo, giữ nguyên code, workspace và knowledge store. |
| zenify e2e | Nhóm lệnh cho journey E2E: lint chống test hời và chạy journey Playwright thật trong Docker. |
| zenify e2e lint | Kiểm tra cơ học các journey trong .znf/e2e, chặn journey thiếu re-fetch, assert hoặc cleanup. |
| zenify e2e login | Đăng nhập trên host bằng harness e2e và ghi Playwright storage state để znf:ui-verifier nạp bằng zenify browser state-load. |
| zenify e2e run | Chạy journey E2E trong Docker, trỏ vào dev server đang mở trên máy bạn. |
| zenify ensure | Ghi hook, model và env của kit vào máy và workspace mà không cần zenify up. |
| zenify env | Quản lý biến môi trường cá nhân cho tool dev và agent trong <workspace>/.zenify/.env, không phải env chạy app. |
| zenify env edit | Mở .zenify/.env bằng $EDITOR, tạo file quyền 0600 nếu chưa có. |
| zenify env exec | Chạy một lệnh với key trong .zenify/.env, che giá trị secret trong stdout và stderr. |
| zenify env list | Liệt kê key trong .zenify/.env: có hay trống, nguồn, mô tả; chỉ in giá trị của key không phải secret. |
| zenify env set | Nhập ẩn giá trị một key vào .zenify/.env, kèm dòng mô tả tuỳ chọn. |
| zenify feature | Liệt kê hoặc bật/tắt các tính năng opt-in của kit trong overlay của workspace. |
| zenify gate | Nhóm lệnh hỗ trợ contract gate, bước quét cross-repo khi bạn chạm tài nguyên chung. |
| zenify gate participants | Liệt kê các repo tham gia contract gate cùng cách mỗi repo truy cập DB chung. |
| zenify guard | Nhóm lệnh cho git-guard, hook chặn commit, push và merge vào branch deploy. |
| zenify guard install | Gắn hook git-guard vào .claude/settings.local.json của workspace để chặn thao tác git vào branch deploy. |
| zenify hotfix | Nhóm lệnh hỗ trợ hotfix, hiện có một lệnh con in base ref đã resolve. |
| zenify hotfix baseref | In base ref mà hotfix của một repo sẽ xuất phát, theo chiến lược khai trong worktree.json. |
| zenify migrate | Gom các repo đang nằm rải ở gốc workspace vào một thư mục con theo layout chuẩn của team. |
| zenify npm | Nhóm lệnh cấu hình npm cho package private trên GitHub Packages. |
| zenify npm login | Đặt NPM_TOKEN từ gh vào shell profile và cấp scope read:packages để npm install được package private. |
| zenify obs | Tóm tắt sức khỏe một route hoặc một trace qua broker, đã che PII và giới hạn kích thước. |
| zenify observe | Nhóm lệnh theo dõi phiên Claude Code: số lần dispatch subagent và lượng tool output. |
| zenify observe report | Tóm tắt số lần dispatch subagent và lượng tool output của từng phiên Claude Code. |
| zenify observe statusline | Vẽ một dòng statusline cho Claude Code với model, ngữ cảnh, số dispatch, tool output và chi phí. |
| zenify observe statusline install | Ghi key statusLine trỏ tới zenify observe statusline vào ~/.claude/settings.json. |
| zenify plane | Nhóm lệnh làm việc với Plane bằng PAT của chính dev. |
| zenify plane create | Tạo work item Plane giao cho chính bạn và in key kèm URL. |
| zenify pm | Chọn đúng package manager JS của project (pnpm, yarn, npm, bun) rồi chạy nó, để không sinh thêm lockfile thứ hai. |
| zenify redis-read | Chạy một lệnh Redis chỉ đọc qua credential broker. |
| zenify release-note | Ghi một commit ghi chú release mang metadata rủi ro, để release report đọc sau. |
| zenify release-report | Sinh báo cáo rủi ro cho một release tag từ lịch sử git của mọi repo trong workspace. |
| zenify reviewer | In ra engine review mà kit sẽ dùng ở phiên này, agent hoặc codex, kèm lý do khi rơi về agent. |
| zenify reviewer get | In engine review đã lưu trong env.ZNF_REVIEWER của <workspace>/.claude/settings.local.json, agent hoặc codex. |
| zenify reviewer set | Đặt engine review của kit, agent hoặc codex, vào env.ZNF_REVIEWER của <workspace>/.claude/settings.local.json. |
| zenify route-log | Xem các record routing model do skill ghi (số liệu plan từ znf:analyze), đếm theo site, model và gate. |
| zenify rules | Nhóm lệnh kiểm tra rule team, hiện có lệnh lint ngôn ngữ cho file agent đọc. |
| zenify rules lint | Kiểm file mà agent đọc (skill, rule, mã nguồn kit): chặn tiếng Việt, và bắt frontmatter khai sai key globs: thay cho paths:. |
| zenify secret-scan | Quét một cây thư mục để tìm secret bị lộ, dùng trong CI và kiểm tra tay trước khi push. |
| zenify skills | Nhóm lệnh quản lý plugin skill znf và bộ coding skill theo repo. |
| zenify skills install | Gỡ bản coding skill cũ khỏi .claude/skills của repo — chúng đã nằm trong plugin znf. |
| zenify skills sync | Ghi bộ skill znf từ binary vào marketplace ~/.zenify/plugin-marketplace và gắn hook znf vào settings của workspace. |
| zenify spec | Nhóm lệnh soi vòng đời spec và registry contract, đọc từ knowledge store. |
| zenify spec contracts | Liệt kê repo và collection mà từng spec khai qua hai tag _Blast-radius: và _DB:. |
| zenify spec status | Liệt kê trạng thái vòng đời của từng spec trong knowledge store. |
| zenify standards | Kiểm tra mỗi FR trong spec có một test thật trên đĩa mà plan đã khai. |
| zenify track | Ghi và báo cáo các lượt cook/fix/hotfix cho pane dev track. |
| zenify track backlog | Quản lý backlog thủ công của pane (thêm, bỏ). |
| zenify track backlog add | Thêm một việc thủ công vào backlog và in track: <bid>. |
| zenify track backlog drop | Bỏ một việc khỏi backlog (bid hoặc id sdd). |
| zenify track ci | Ghi kết quả CI green hoặc red của commit đang được watch. |
| zenify track close-day | Chốt ngày làm việc trước, archive log cũ hơn 14 ngày. |
| zenify track end | Đóng một lượt theo dõi với PR, branch, rollback hoặc cancelled; đếm số task từ ledger SDD và lưu đường dẫn plan từ dòng đầu. |
| zenify track est | Đặt size ước lượng cho id đã start; dòng est sau cùng thắng. |
| zenify track fix | Ghi một vòng fix của lượt fix/hotfix: đường chẩn đoán narrow hoặc wide và có regression test hay không. |
| zenify track onboard | Nạp dữ liệu ban đầu cho track. |
| zenify track onboard history | Xem trước hoặc ghi lịch sử làm việc lấy từ transcript Claude Code. |
| zenify track onboard memory | Đánh dấu đã onboard từ memory (dòng onboard · memory). |
| zenify track plan | Quản lý kế hoạch trong ngày của pane (đặt danh sách việc). |
| zenify track plan add | Thêm các mục vào kế hoạch hôm nay và in track: plan <n> items. |
| zenify track plan rm | Bỏ các mục khỏi kế hoạch hôm nay và in track: plan <n> items. |
| zenify track plan set | Ghi kế hoạch hôm nay từ các id đã cho và in track: plan <n> items. |
| zenify track ship | Ghi kết quả một lần chạy znf🚢 shipped hay blocked, bước bị chặn, số finding và số vòng fix. |
| zenify track start | Mở một lượt theo dõi và in id track: <id>. |
| zenify track stats | In số liệu hôm nay, độ chính xác estimate và chất lượng từ log.md và sessions/*.log. |
| zenify ui-verify | Nhóm lệnh ghi/kiểm tra bằng chứng UI-verify cho gate cơ học của /znf:ship. |
| zenify ui-verify check | Gate fail-closed kiểm tra artifact UI-verify còn khớp fingerprint hiện tại. |
| zenify ui-verify files | In các file render UI đã đổi so với base, mỗi dòng một file; file test không tính. |
| zenify ui-verify record | Ghi lại artifact UI-verify (screenshot + 3 số đo) cho fingerprint hiện tại. |
| zenify up | Onboard máy vào workspace: clone repo, ghi cấu hình, gắn hook và skill, chuẩn bị knowledge store. |
| zenify update | Nâng cấp binary ZenifyKit lên bản mới nhất bằng đúng kênh đã cài, hoặc chỉ kiểm tra có bản mới. |
| zenify version | In phiên bản binary ZenifyKit đang chạy. |
| zenify visual | Nhóm lệnh visual regression: chụp từng route và so với ảnh baseline đã commit. |
| zenify visual check | So ảnh chụp từng route với baseline, hoặc chụp lại baseline khi giao diện đổi có chủ ý. |
| zenify wt | Nhóm lệnh quản lý worktree theo slug: tạo, liệt kê, gỡ, dọn, kèm port và môi trường dev riêng cho từng task. |
| zenify wt base | In base thật của worktree hiện tại, để skill tính merge-base đúng. |
| zenify wt config | In cấu hình worktree đã resolve của repo hiện tại, hoặc port sẽ cấp cho một key. |
| zenify wt ls | Liệt kê worktree trong repo hiện tại, kèm branch, port, trạng thái merge và dev server đang chạy. |
| zenify wt new | Tạo worktree mới cho một task, kèm branch, port riêng và môi trường dev đã seed. |
| zenify wt path | In đường dẫn tuyệt đối của worktree theo slug. |
| zenify wt promote | Đổi thư mục node_modules dạng symlink của một worktree thành bản copy riêng. |
| zenify wt rm | Gỡ một worktree đã xong việc, từ chối khi còn thay đổi chưa commit hoặc branch chưa merge. |
| zenify wt sweep | Dọn mọi worktree đã merge và sạch trong repo, dừng dev server của chúng trước khi gỡ. |
| zenify wt url | In địa chỉ http://localhost:<port> của dev server thuộc một slug. |
| zenify wt wire | Trỏ file env của worktree hiện tại sang dev server của các service liên quan đang được sửa cùng slug. |
Lệnh nội bộ
Hook và skill gọi các lệnh này; bạn không cần gõ tay nên chúng không có trang riêng.
| Lệnh | Mô tả |
|---|---|
zenify git-guard | Hook PreToolUse: chặn commit/merge/push vào deploy branch + secret đã stage |
zenify hooks-run | Bộ điều phối nội bộ cho hook znf (chỉ chạy trong workspace, fail-open) |
zenify observe count | PreToolUse hook: đếm dispatch Task + soft-cap warn (không chặn) |
zenify observe meter | PostToolUse hook: đo tool-output per-session; nhắc khi một result > 50KB hoặc phiên > 2MB (không sửa output) |
zenify plane-mcp | Plane MCP server (stdio) bằng PAT của chính dev; Claude Code tự chạy, không gõ tay |
zenify review-bundle | Cơ học chia diff lớn thành bundle cụm-file cho znf:review (seam BUNDLE) |
zenify review-codex | Chạy codex review rồi in findings JSON của kit (adapter, seam review engine) |
zenify review-verify | Cơ học verify findings của znf:review vs file thật (findings JSON qua stdin, seam VERIFY) |
zenify route-log record | Ghi một route record (JSON qua stdin), best-effort |
zenify route-log record-plan | Đếm task và file trong plan, ghi record site=plan-metrics |