One repository for small command-line tools that are too small for a repo of their own. Each tool keeps its own language, tests, and install line. The first is bash-guard, a Claude Code hook that catches three habits that waste time and tokens in a coding-agent session, before the command runs, and tells the agent why so it changes course on its own.
Overview
developer-toolbox collects small command-line tools for everyday development. Each tool lives in its own folder with its own tests and install line, can be used without the rest, and is released with its own version tag.
The first tool is bash-guard, a Claude Code hook. Before each shell command an agent runs, it checks for three habits: polling the same read-only command in a loop, starting a dev server in the foreground so the session hangs, and running cd into a folder that is no longer there. When it blocks a command, it tells the agent why in plain words.
bash-guard 0.1.0 was released in October 2026 under the MIT license. It needs Python 3.10 or later, has no dependencies, and runs on macOS and Linux.
Features
What bash-guard catches
- The same no-op or read-only command (tail, cat, ls, echo) run three times in two minutes with nothing changing in between
- Dev servers (npm run dev, bun dev, next dev, vite, expo start) started in the foreground without a timeout or background flag
- A leading cd into a directory that does not exist, usually a removed worktree
- Tests, builds, and git commands are never treated as polling
Safe to try
- Starts in shadow mode: it logs what it would have blocked and never blocks
- Switch to enforce once the log looks right, or turn it off
- Fails open: bad input, a full disk, or a bug in the hook never blocks a command
- bash-guard install adds the hook to Claude Code's settings and keeps the rest of the file
Private logs
- Logged commands are redacted: home paths, tokens and secrets, credentials in URLs, emails, hostnames, and IP addresses
- Logs are readable only by you and are pruned after 14 days
- Command logging can be switched off entirely
- No network calls
Works with coding agents
- bash-guard status --json prints a versioned schema
- Exit codes: 0 success, 1 runtime error, 2 usage error; nothing prompts
- Includes a SKILL.md that tells an agent what a denial means and how to respond
Technical Details
Install
uv tool install "git+https://github.com/Neilsmahajan/developer-toolbox#subdirectory=tools/bash-guard", then bash-guard install. pipx works too.
Testing
Over 100 tests cover the rules, the redaction, the hook, and the settings installer, plus a clean-install test that builds the wheel. CI is path-filtered per tool, and every push is scanned with gitleaks over the full history.