Settings¶
settings.json (Windows / PowerShell host) and settings-unix.json
(POSIX / bash host) carry the harness configuration: hook wiring,
tool permissions, environment variables, and status-line settings.
The full canonical reference lives at settings-reference.md. This page summarizes the contract and points at the deeper reference.
Sections¶
| Section | Purpose |
|---|---|
permissions |
Tool whitelists and blacklists per matcher |
hooks |
Event-keyed hook command table (the canonical wiring) |
env |
Per-session environment variables |
statusLine |
Status-line template the host renders |
Paired-template invariant¶
The two files are an OS-paired template. Every key resolves to one of:
- Identical values (cross-OS-portable settings).
- OS-axis intentional drift (host-shell families — PowerShell
command bodies and
shell: "powershell"declarations on the Windows side; bash command bodies andshell: "bash"declarations on the POSIX side).
Every other key remains identical across the pair. New keys land in both files atomically.