feat: add PreToolUse hook to block interactive cp/mv/rm prompts (bd-tm2p)

Polecats hang indefinitely when macOS shell aliases add -i (interactive)
flags to cp/mv/rm. This adds a Claude Code PreToolUse hook that blocks
these commands unless -f flag or alias-bypass (command prefix, absolute
path) is present.

Changes:
- New hook: .claude/hooks/block-interactive-cmds.sh
- Register hook in .claude/settings.json
- Add non-interactive guidance to default agents.md template

Executed-By: beads/polecats/jasper
Rig: beads
Role: polecats
This commit is contained in:
jasper 2026-02-27 16:13:10 -08:00 • committed by Steve Yegge
commit 6abc586ba2
3 changed files with 59 additions and 0 deletions

View file

@ -0,0 +1,31 @@
#!/bin/bash
# Block cp/mv/rm without -f flag to prevent interactive prompt hangs.
#
# Problem: macOS shell profiles often alias cp/mv/rm with -i (interactive),
# causing AI agents to hang indefinitely waiting for y/n input they can't
# provide. Observed in multiple polecats during swarm operations.
#
# Solution: Block these commands unless -f flag or alias-bypass is present.
# The agent can easily retry with -f added.
COMMAND=$(jq -r '.tool_input.command' < /dev/stdin)
for cmd in cp mv rm; do
# Match: cmd at word boundary, followed by space and arguments
# Skip if: -f flag present, or using 'command' builtin / absolute path / backslash
if echo "$COMMAND" | grep -qE "(^|[;&|] *)${cmd} " && \
! echo "$COMMAND" | grep -qE "(^|[;&|] *)${cmd} +-[a-eg-zA-Z]*f" && \
! echo "$COMMAND" | grep -qE "(command +${cmd}|/bin/${cmd}|/usr/bin/${cmd})" && \
! echo "$COMMAND" | grep -qE "(^|[;&|] *)\\\\${cmd} "; then
jq -n --arg cmd "$cmd" '{
hookSpecificOutput: {
hookEventName: "PreToolUse",
permissionDecision: "deny",
permissionDecisionReason: ("BLOCKED: `" + $cmd + "` without `-f` flag may hang on interactive prompts (macOS often aliases `" + $cmd + "` to `" + $cmd + " -i`). Use `" + $cmd + " -f ...` instead, or prefix with `command " + $cmd + "` to bypass aliases.")
}
}'
exit 0
fi
done
exit 0

View file

@ -7,6 +7,10 @@
{
"type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-gh-watch.sh"
},
{
"type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-interactive-cmds.sh"
}
]
}

View file

@ -12,6 +12,30 @@ bd close <id> # Complete work
bd sync # Sync with git
```
## Non-Interactive Shell Commands
**ALWAYS use non-interactive flags** with file operations to avoid hanging on confirmation prompts.
Shell commands like `cp`, `mv`, and `rm` may be aliased to include `-i` (interactive) mode on some systems, causing the agent to hang indefinitely waiting for y/n input.
**Use these forms instead:**
```bash
# Force overwrite without prompting
cp -f source dest # NOT: cp source dest
mv -f source dest # NOT: mv source dest
rm -f file # NOT: rm file
# For recursive operations
rm -rf directory # NOT: rm -r directory
cp -rf source dest # NOT: cp -r source dest
```
**Other commands that may prompt:**
- `scp` - use `-o BatchMode=yes` for non-interactive
- `ssh` - use `-o BatchMode=yes` to fail instead of prompting
- `apt-get` - use `-y` flag
- `brew` - use `HOMEBREW_NO_AUTO_UPDATE=1` env var
<!-- BEGIN BEADS INTEGRATION -->
## Issue Tracking with bd (beads)