diff --git a/.claude/hooks/block-interactive-cmds.sh b/.claude/hooks/block-interactive-cmds.sh new file mode 100755 index 000000000..de5ca3b6d --- /dev/null +++ b/.claude/hooks/block-interactive-cmds.sh @@ -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 diff --git a/.claude/settings.json b/.claude/settings.json index 580b16c7a..159340534 100644 --- a/.claude/settings.json +++ b/.claude/settings.json @@ -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" } ] } diff --git a/internal/templates/agents/defaults/agents.md.tmpl b/internal/templates/agents/defaults/agents.md.tmpl index f9f761841..f923f4bdb 100644 --- a/internal/templates/agents/defaults/agents.md.tmpl +++ b/internal/templates/agents/defaults/agents.md.tmpl @@ -12,6 +12,30 @@ bd close # 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 + ## Issue Tracking with bd (beads)