Skip to content
BYOK Tools

Butterfish

Shell wrapper that adds LLM prompting and autosuggest to bash and zsh.

3.8 editor score•Command Line•Free & open source

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

How we score
89/ 100

Grade A

Your key is stored on your device and requests go directly to the provider.

  • Key storage

    Key stays on your device; requests go direct to the provider.

    40/40
  • Auditable code

    Open source: anyone can verify how keys are handled.

    25/25
  • Self-hosting

    Runs as a local app, but not as a self-hosted service.

    8/15
  • Offline option

    Supports local models, so no key is needed at all for private work.

    10/10
  • Provider choice

    3 provider options, which lets you pick the provider whose data terms you trust.

    6/10

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.