Installing is one command — you paste it, and nothing else. It downloads the latest release, verifies the checksum, extracts it, checks dependencies, installs into your repo, and verifies the wiring (--strict) — in that order, fail-fast at the first problem. No preflight to run first, no follow-up scripts to chain. Requirements: Python ≥ 3.12, git, and Claude Code.Cài đặt là một lệnh — bạn dán vào, hết. Nó tải bản release mới nhất, kiểm checksum, giải nén, kiểm phụ thuộc, cài vào repo, rồi xác nhận wiring (--strict) — theo đúng thứ tự đó, dừng ngay ở lỗi đầu tiên. Không phải chạy preflight trước, không script nối tiếp. Yêu cầu: Python ≥ 3.12, git, và Claude Code.

Install online — one lineCài online — một dòng

Run this from inside the repo you want the harness in. It resolves the latest release from GitHub, downloads the bundle, and installs it — you never touch a version number or a download link.Chạy ngay trong repo bạn muốn có harness. Nó tự tìm bản mới nhất trên GitHub, tải bundle, và cài — bạn không cần đụng tới số phiên bản hay đường tải nào.

Linux / macOSLinux / macOS

Windows (PowerShell)Windows (PowerShell)

Watch one thing: the closing verify. After it copies harness/ and wires the hooks into .claude/settings.json (additively — your own hooks survive), the installer runs verify_install --strict as the final gate. A clean run ends with verify_install OK and exit 0. It is not silent: a fresh install prints ~12 WARN lines, and every one is expected — ten name a hook the shipped table disables whose entrypoint stays wired (it spawns and self-no-ops, costing a spawn and nothing else), and one names the config you are meant to localize. The verdict line is the proof, not the absence of warnings. real outputChỉ cần nhìn một thứ: verify chốt. Sau khi copy harness/ và gắn hook vào .claude/settings.json (cộng thêm — hook của bạn vẫn còn), trình cài chạy verify_install --strict làm gate cuối. Một lần chạy sạch kết thúc bằng verify_install OK và exit 0. Nó KHÔNG im lặng: bản cài mới in ~12 dòng WARN, và tất cả đều nằm trong dự kiến — mười dòng gọi tên một hook mà bảng ship tắt sẵn nhưng entrypoint vẫn còn gắn (nó spawn rồi tự no-op, tốn một lần spawn chứ không gì khác), một dòng gọi tên đúng phần cấu hình bạn được quyền chỉnh. Dòng phán quyết mới là bằng chứng, không phải việc vắng cảnh báo. đầu ra thật

WARN harness/bin/hs-cli: not reachable on PATH — skill bodies tell the user to type `hs-cli`. Fix: `ln -s <repo>/harness/bin/hs-cli ~/.local/bin/hs-cli` (or `install.py --cli` for every launcher; Windows: add <repo>/harness/bin to PATH)
… 5 more of the same shape (hs-run, hs-code, hs-rops, hs-secrets, hs-usage: a launcher not yet linked onto PATH)
WARN harness/data/harness-hooks.yaml: bash_write_guard: enabled=false in the SSOT but its entrypoint is still wired in .claude/settings.json — not a bug (the process spawns and self-no-ops each matching event under the wire-then-toggle pattern), but it costs a spawn; unwire it there too if you want zero per-event cost
… 9 more of the same shape (a hook disabled in the SSOT whose entrypoint stays wired)
WARN harness/data/harness-hooks.yaml: hash mismatch (deployer-localized config — expected to differ from the shipped baseline)
verify_install OK: manifest + hook registration consistent

Offline — install a downloaded bundleOffline — cài từ bundle đã tải

No network on the target? Download the release bundle harness-<version>.tar.gz (with its .sha256) and the standalone install.sh elsewhere, copy them over, and point the installer at the bundle and your repo. Same five steps, same closing verify — it just skips the download.Máy đích không có mạng? Tải bundle release harness-<version>.tar.gz (cùng .sha256) và install.sh độc lập ở nơi khác, copy sang, rồi trỏ trình cài vào bundle và repo của bạn. Cùng năm bước, cùng verify chốt — chỉ bỏ bước tải.

OptionsTùy chọn

The post-install test suite is off by default now — one command installs and verifies, and that is it. Add --run-tests only if you want to watch the suite go green in your own environment. --skip-tests / --no-tests still work as harmless no-ops.Bộ test sau cài giờ mặc định tắt — một lệnh cài và verify, thế là xong. Chỉ thêm --run-tests nếu muốn xem bộ test chạy xanh trong môi trường của mình. --skip-tests / --no-tests vẫn chạy như no-op vô hại.

From a clone (advanced)Từ một clone (nâng cao)

If you already have the harness checked out, skip the bundle and run the installer directly — same writes, same final verify. Every mutation is idempotent and previewable with --dry-run. Keep the extracted harness outside the repo you install into: if source == target the copy is a no-op and nothing installs.Nếu đã có harness sẵn, bỏ qua bundle và chạy thẳng trình cài — cùng cách ghi, cùng verify cuối. Mọi thay đổi đều idempotent và xem-trước được bằng --dry-run. Để thư mục harness vừa giải nén ở ngoài repo định cài: nếu source trùng target thì bước copy thành no-op, không cài được gì.

Direct-installer flags: --non-interactive / --yes (never prompt — the automation path), --dry-run (plan every write, change nothing), --no-track (run without committing harness/ into your product git), --uninstall (reverse the settings + pre-push edits; harness/ is left in place).Cờ của trình cài trực tiếp: --non-interactive / --yes (không hỏi — đường tự động), --dry-run (lập kế hoạch mọi lần ghi, không đổi gì), --no-track (chạy mà không commit harness/ vào git sản phẩm), --uninstall (đảo ngược chỉnh settings + pre-push; harness/ vẫn để nguyên).

Install onto another coding agentCài lên một coding agent khác

The harness is not only for Claude Code. harness/data/runtime-targets.yaml declares what nine other coding-agent runtimes can actually carry — event names, tool vocabulary, hook-file shape, skill-name constraints — and the installer casts that table into a real install instead of a copy that looks installed and fires nothing. An undeclared name is refused, never approximated.Harness không chỉ dành cho Claude Code. harness/data/runtime-targets.yaml khai báo chín runtime coding-agent khác thực sự mang được gì — tên event, từ vựng tool, hình dạng file hook, ràng buộc tên skill — và trình cài đúc bảng đó thành một install THẬT thay vì một bản copy trông như đã cài mà không bắn gì. Tên chưa khai báo bị từ chối, không bao giờ đoán gần đúng.

CSV for several at once (--runtime codex,cursor,grok). Two of the nine live in your home, not a project, so they take a deliberately separate flag — installing them changes every project you own, and that is never a side effect of installing here: --runtime-home agy. Both reverse with --uninstall, which reads an ownership ledger the install itself wrote: a file you have since edited is kept and reported, never deleted.Dùng CSV để cài nhiều cái một lúc (--runtime codex,cursor,grok). Hai trong chín cái sống ở home chứ không phải trong dự án, nên chúng có cờ RIÊNG cố ý — cài chúng là đổi mọi dự án bạn sở hữu, và đó không bao giờ là tác dụng phụ của việc cài ở đây: --runtime-home agy. Cả hai đảo ngược bằng --uninstall, đọc sổ sở-hữu mà chính lần cài đã ghi: file bạn đã sửa từ đó thì được giữ lại và báo, không bao giờ bị xoá.

Want to see what survives before writing anything? hs-cli emit --target codex --json reports the projection read-only; --out DIR writes a runnable bundle (hooks file + degradation ledger + operator notes) into a directory of your choice. Note it is a projection, not a tracked install — --out has no ledger of its own, so reversing it means deleting that directory yourself.Muốn xem cái gì sống sót trước khi ghi bất cứ thứ gì? hs-cli emit --target codex --json báo cáo phép chiếu ở chế độ chỉ-đọc; --out DIR ghi một bundle chạy được (file hook + sổ suy-giảm + ghi chú vận hành) vào thư mục bạn chọn. Lưu ý đây là phép CHIẾU, không phải bản cài có theo dõi — --out không có sổ riêng, nên muốn đảo ngược thì tự xoá thư mục đó.

FAQHỏi đáp