Skip to content

docs(hooks): correct hook-command examples to bare script paths#64

Merged
dstolts merged 1 commit into
mainfrom
docs/hook-command-format
May 20, 2026
Merged

docs(hooks): correct hook-command examples to bare script paths#64
dstolts merged 1 commit into
mainfrom
docs/hook-command-format

Conversation

@dstolts

@dstolts dstolts commented May 20, 2026

Copy link
Copy Markdown
Owner

docs(hooks): correct hook-command examples to bare script paths

What

Fixes the settings.local.json hook examples in docs/hooks-guide.md (7),
docs/configuration-reference.md (1), and docs/enterprise-security.md (1):
each command is now a bare script path, not bash "<path>". Adds a note
in hooks-guide.md explaining the correct format and the failure mode.

Why

The docs taught the shell-prefixed command form that fails at runtime with
"bash.exe: bash.exe: cannot execute binary file" (the installer bug fixed in
v0.4.1). Docs must teach the corrected format so anyone hand-editing
settings.local.json does not reintroduce the bug.

Risk

None. Documentation only.

Test plan

  • no "command": "bash examples remain in docs (method: grep)

## What
Fixes the settings.local.json hook examples in docs/hooks-guide.md (7),
docs/configuration-reference.md (1), and docs/enterprise-security.md (1):
each `command` is now a bare script path, not `bash "<path>"`. Adds a note
in hooks-guide.md explaining the correct format and the failure mode.

## Why
The docs taught the shell-prefixed `command` form that fails at runtime with
"bash.exe: bash.exe: cannot execute binary file" (the installer bug fixed in
v0.4.1). Docs must teach the corrected format so anyone hand-editing
settings.local.json does not reintroduce the bug.

## Risk
None. Documentation only.

## Test plan
- [x] no `"command": "bash` examples remain in docs (method: grep)
@dstolts dstolts merged commit 828a86a into main May 20, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant