Your terminal speaks English now.
BashBuddy is a local AI assistant that turns plain English into bash commands. Tell it what you want. It plans. You confirm. Done.
$ bashbuddy
BashBuddy v0.1.0 · type in plain English
> compress the 3 biggest files in this folder and move them to ~/archive
I understand: find the 3 largest files, gzip-compress them, move to ~/archive.
Steps:
1. Find 3 largest files with du + sort
2. Compress each with gzip
3. Move to ~/archive/
Confirm step 1? [y/N]█
// how it works
Three steps. Zero confusion.
You describe what you want in plain language. BashBuddy thinks it through, shows you the plan, and waits for your go-ahead.
You speak
Type your request in plain English. No need to remember flags, options, or syntax.
BashBuddy plans
It understands the goal, shows you exactly what it's going to do — step by step — before touching anything.
You confirm
Nothing runs without your approval. Destructive commands get a WARNING. You stay in control.
// live demo
See it in action
A real session. Nothing scripted.
// features
Built the right way
Runs 100% locally
Your commands, your machine, your data. No cloud, no telemetry, no API keys required.
Safety first
Dangerous operations (rm, dd, kill, chmod 777) are always flagged with a clear warning before execution.
Auto model selection
The installer detects your GPU/RAM and picks the right model tier — no manual configuration.
Remembers context
Session history is preserved so you can ask follow-up questions and refine commands naturally.
Works in tmux
Runs in a persistent tmux pane alongside your work. No window switching, no context loss.
One-line install
One curl command installs everything: Ollama, the right model, tmux, and the CLI. Just run and go.
// install
One command. Everything set up.
Installs Ollama, picks the right model for your hardware, sets up the CLI, and has you running in under 60 seconds.
Requires: Linux or macOS · Python 3.9+ · ~4–15GB disk (model dependent)
LOW
qwen2.5-coder:3b
< 8GB VRAM
~2GB
MID
qwen2.5-coder:7b
≥ 8GB VRAM or ≥ 16GB RAM
~4.7GB
HIGH
qwen2.5-coder:14b
≥ 16GB VRAM
~9GB
After installing
# open a new terminal, then:
$ bashbuddy
BashBuddy v0.1.0 · type your request in plain English
> how do I check disk usage by folder?
...
Stop memorizing commands.
BashBuddy is free, open source, and runs entirely on your machine.