Ghost Peony LLC

What is BashBros?

BashBros is security middleware and an AI sidekick for Bash agents. It gives you visibility, controls, and protection for any Bash-based AI agent, plus a local AI assistant powered by Ollama that knows your system.

How does BashBros protect my system?

BashBros includes 9 security modules: command filtering to allow or block commands by pattern, path sandboxing to restrict filesystem access, secrets guard to block access to .env files and credentials, audit logging for full command history, rate limiting to prevent runaway agents, risk scoring from 1-10, loop detection, anomaly detection, and output scanning to redact leaked secrets.

What is the AI sidekick in BashBros?

The AI sidekick (called Bash Bro) uses local Ollama models to provide smart suggestions, explain commands in plain English, generate scripts from descriptions, analyze command safety, and route simple tasks to local models instead of expensive cloud APIs. It learns your system via the bashbros scan command.

How do I install BashBros?

Install BashBros globally with npm: npm install -g bashbros. Then run bashbros init to configure security settings, bashbros scan to learn your system, and bashbros watch to start protection. The entire setup takes about 60 seconds.

What security modules does BashBros include?

BashBros includes 9 security modules: Command Filter, Path Sandbox, Secrets Guard, Audit Log, Rate Limiter, Risk Scorer, Loop Detector, Anomaly Detector, and Output Scanner. It also includes an Undo Stack for rolling back file changes.

Is BashBros free?

Yes, BashBros is free and open source under the MIT License. It is available on npm and GitHub.

Does BashBros work with Claude Code?

Yes, BashBros has dedicated Claude Code integration through hooks. Run bashbros hook install to set up hooks that gate and record every Bash command Claude Code executes. It also works with other agents like Aider, Moltbot, OpenCode, and any Bash-based agent.