Butterfish
Shell wrapper that adds LLM prompting and autosuggest to bash and zsh.
Overview
Butterfish wraps your shell so you can prompt an LLM with recent shell history as context, get command autosuggestions and run a goal-driven agent mode. It uses an OpenAI key or any OpenAI-compatible base URL.
- Shell history as context
- Command autosuggest
- Goal mode agent
- Custom base URL
Our verdict
What we like
- Context-aware prompts
- Works in existing shell
Watch out for
- macOS and Linux only
Works with these providers
Keys from these providers work in this app. Usage is billed by the provider at its list price.
BYOK Key Safety Score
Key handling in Butterfish
Grade A
Your key is stored on your device and requests go directly to the provider.
- Key storage40/40
Key stays on your device; requests go direct to the provider.
- Auditable code25/25
Open source: anyone can verify how keys are handled.
- Self-hosting8/15
Runs as a local app, but not as a self-hosted service.
- Offline option10/10
Supports local models, so no key is needed at all for private work.
- Provider choice6/10
3 provider options, which lets you pick the provider whose data terms you trust.
Whatever the score, give each app its own key, set a monthly spend limit with your provider, and revoke keys you no longer use. Read the key-safety checklist.
Butterfish FAQ
- Does Butterfish support bring your own key?
- Yes. Butterfish accepts your own API key from OpenAI, Ollama and OpenAI-compatible. Usage is billed by the provider at its API rates.
- Where does Butterfish store my API key?
- On your device. Requests go directly from Butterfish to the provider. Its BYOK Tools Key Safety Score is 89/100.
- Is Butterfish free?
- Open source: Free & open source. API usage is billed separately by your model provider.
- Is Butterfish open source?
- Yes. The source code is at https://github.com/bakks/butterfish.
- Can Butterfish run local models?
- Yes. It can connect to local runtimes such as Ollama or LM Studio, so no API key is needed for private or offline use.
- Which platforms does Butterfish support?
- CLI.
Community reviews
No reviews yet.
Alternatives to Butterfish
All command line →LLM (Simon Willison)
Command Line
CLI and Python library for interacting with any LLM.
Fabric
Command Line
Open-source framework of crowdsourced AI prompts for the CLI.
AIChat
Command Line
All-in-one LLM CLI with chat REPL, RAG, agents and a local server.
Open Interpreter
Command Line
Let language models run code on your computer from a terminal.
ShellGPT
Command Line
Command-line productivity tool for generating shell commands and answers.
Mods
Command Line
AI on the command line from Charm, built for pipelines.