← Back to list
01Issue
FeatureOpenSwamp ClubPublic
AssigneesNone
Relationships
#4448 Docs: Claude audit hook covers PowerShell, swamp audit install --user, and doctor audit hook warnings
Opened by stack72 · 11/5/2026
swamp-club#4009 changes how the Claude Code audit hook works. The manual needs to catch up in three pages.
content/manual/how-to/ai-agents/claude-code.md
swamp repo initandswamp repo upgradenow write the audit hook with matcherBash|PowerShell, so calls through Claude Code's PowerShell tool are recorded.swamp repo upgradewidens the Bash-only hook that earlier versions wrote.- Claude Code reads
.claude/settings.local.jsonfrom the git root (the start folder on Windows), so a swamp repo nested below its git root, or a session started above the repo, does not run the repo's hook.swamp audit install --useradds the hook to the Claude Code user settings (~/.claude/settings.json, orsettings.jsoninCLAUDE_CONFIG_DIR), which covers every repo.swamp audit uninstall --userremoves only the entries swamp added.
content/manual/how-to/use-the-audit-timeline.md
- With the user-level hook, a call is recorded when its working directory is inside a swamp repo. A
cdinside a subshell, or--repo-dirrun from above the repo, is not recorded. - The user-level hook runs swamp on every Bash and PowerShell call in every project, not only swamp ones.
content/manual/reference/doctor.md
agent-config-loadablefor Claude now accepts a user-level hook when the repo file has none.- It passes with a warning when the repo sits below its git root and no hook can fire, and when the repo and user settings run different audit hooks (each call recorded twice).
- Log output marks a warned check with
!and adds a "N warned" count;overallStatusiswarn, and the JSON check result carries awarningfield. Onlyfailexits non-zero.
02Bog Flow
Open
No activity in this phase yet.
03Sludge Pulse
Sign in to post a ripple.