Your Friendly
Bash Agent Helper

BashBros gives you visibility, controls, and protection for CLI agents—plus an AI sidekick that actually knows your system.

Get Started See Features
BashBros - Friendly terminal assistant
Quick Install:
$ npm install -g bashbros
FEATURES

Everything You Need

Visibility, controls, and protection for your CLI agents—all in one place.

🛡️

Command Filter

Allow or block commands by pattern. Your rules, your control.

📁

Path Sandbox

Restrict filesystem access to keep agents where they belong.

🔐

Secrets Guard

Automatically block access to .env files, keys, and credentials.

📋

Audit Log

Full command history with violation tracking for complete visibility.

⚡

Rate Limiter

Prevent runaway agents with configurable rate limits.

🤖

AI Sidekick

Local Ollama integration for smart suggestions and task routing.

SETUP

Up and Running in 60 Seconds

1

bashbros init

Interactive setup wizard configures your security profile and preferences.

2

bashbros scan

Learns your system—tools, versions, project type—for smart suggestions.

3

bashbros watch

Start protection. Your Bash Bro is now watching your back.

$ bashbros route "git status"
🤝 Route: Bash Bro (90% confidence)
$ bashbros do "find large files"
→ find . -size +100M -type f
$ bashbros safety "rm -rf /"
⚠ Risk Level: CRITICAL
✓ Command blocked

Your AI Sidekick That Gets It

BashBros doesn't just protect—it helps. Natural language commands, smart routing, and context-aware suggestions.

  • Explain any command in plain English
  • Generate scripts from descriptions
  • Route simple tasks to local models
  • Analyze command safety before execution
  • Run background tasks in parallel
COMMANDS

Simple, Powerful CLI

Protection
init Setup wizard
watch Start protection
allow <cmd> Allow command
audit View history
Bash Bro
scan Learn your system
suggest Get suggestions
route <cmd> Check routing
run <cmd> Execute via Bro
AI Features
explain <cmd> Explain command
fix <cmd> Fix failed command
script <desc> Generate script
safety <cmd> Analyze risks
Natural Language
do <desc> Text → command
ai <prompt> Ask anything
help-ai <topic> Get help
models List Ollama models

Works With Your Favorite Agents

Claude Code
Clawdbot
Aider
OpenCode
Ollama
Any CLI Agent

Get Your Bash Bro Today

One command to install. 60 seconds to configure. Peace of mind forever.

View on GitHub