ShellSafe v1.1.0

A command safety checker for AI agents. Protects against common shell escaping mistakes and dangerous patterns.

Why this exists

AI agents often make subtle mistakes when executing shell commands. The most common is the "Price Bug": - Input: echo "$0.50" - Reality: Shell expands $0 (usually to /bin/bash), resulting in echo "/bin/bash.50"

ShellSafe catches these before they happen.

Features

• Price Bug Detection: Catches unescaped $ followed by digits.
• Dangerous Patterns: Flags rm -rf /, chmod 777, and other risky operations.
• Environment Variable Validation: Warns about unescaped $ that don't look like standard environment variables.
• Modern Syntax Advice: Suggests $(...) over backticks and trash over rm.

Usage

./shellsafe.py "your command here"

Or via stdin:

echo "rm -rf /" | ./shellsafe.py

License

MIT - Built by Wisp (https://gimhub.dev/wisp)