Is Butterfish Shell free?

The tool itself is open source under the MIT license. Model calls go to the OpenAI API (or another compatible endpoint) on your own key, so you pay for that usage.

Which shells and platforms are supported?

Butterfish works on macOS and Linux and wraps bash or zsh; you can install it with Homebrew or go install.

Can I use a local model?

Yes. Set --base-url to any server with an OpenAI-compatible API, such as a local endpoint, and choose the model with -m.

What is Butterfish Shell's monthly traffic and growth trend?

Butterfish Shell currently receives 34 monthly visits, with a month-over-month traffic change of -1.33K (-97.5% growth rate). Its primary source market is Global (— share), including 14 direct visits/mo and 0 organic search visits/mo.

Is Butterfish Shell free? What is its pricing model?

Butterfish Shell operates on a Flexible pricing model. Free and open source under the MIT license; you pay for your own OpenAI (or compatible) API usage. Autosuggest is usually the most expensive feature and can be disabled or slowed down to reduce spend. Supported billing and checkout platforms include: not listed.

Butterfish Shell: AI Prompting and Autocomplete for bash and zsh

OpenAITools

About Butterfish Shell

Capital-letter prompting

Start any command with a capital letter to send it to the model instead of the shell, with recent shell input and output included as context.

GPT autosuggest

Suggests shell commands as you type; press Tab to accept a suggestion.

Goal Mode agent

Start a command with ! to have the agent propose commands toward a goal, or with !! to execute them without confirmation.

Transparent, editable prompts

Prompt wrappers are kept in ~/.config/butterfish/prompts.yaml, and verbose mode prints the raw requests sent to the model.

Any OpenAI-compatible endpoint

Point --base-url at a local or third-party server that implements the OpenAI API, and choose the model with -m.

Extra CLI commands

prompt, summarize, gencmd, exec, index and indexquestion cover prompting, file summaries, command generation and embedding search.

Butterfish Shell is an open-source (MIT) command-line tool that wraps your existing bash or zsh session and adds AI prompting on top of it. You keep using the shell as usual; starting a command with a capital letter sends it to the AI instead of the shell, and the request includes your recent shell history and output so you can ask contextual questions such as why the previous command failed.

It also provides GPT-powered autosuggest that you accept with Tab, a Goal Mode in which the agent proposes and iterates on commands to reach a goal (start a command with ! to confirm each step, or !! to run without confirmation), and CLI subcommands for prompting, summarizing files, generating commands and indexing local files for embedding search. Prompts live in a readable prompts.yaml, and any OpenAI-compatible base URL can be used, including local models. Butterfish needs your own OpenAI (or compatible) API key and bills API usage to that account.

High-Impact Use Cases for Butterfish Shell

Developers and sysadmins

Debug commands without leaving the terminal

Ask why a command failed and get a corrected command while the shell history is already in context.

Command-line power users

Faster command entry

Accept AI autosuggestions with Tab for routine commands and long flag combinations.

Engineers exploring a codebase

Search local files by meaning

Index a directory with embeddings and ask questions about its contents from the CLI.

Top 12 Butterfish Shell Alternatives & Competitors

Side-by-side telemetry comparison of competing AI tools in the same primary category

View All Butterfish Shell Alternatives →Explore all AI Chatbot tools →

Rank	AI Tool	Monthly Visits	MoM Growth	Direct traffic share	Pricing	Head-to-Head
●	Butterfish Shell	34	-97.5%	41% direct	Flexible	Current
1	ChatGPT	6.05B	+2.2%	73% direct	Freemium	vs ChatGPT
2	Google Gemini	2.64B	-0.1%	62% direct	Freemium	vs Google Gemini
3	Claude	1.25B	+23.8%	72% direct	Freemium	vs Claude
4	DeepSeek	372.76M	+4.3%	78% direct	Freemium	vs DeepSeek
5	OpenAI Platform	234.68M	-9.6%	45% direct	Paid	vs OpenAI Platform
6	Grok	203.85M	-0.8%	66% direct	Freemium	vs Grok