Butterfish

Butterfish is a command-line tool that integrates AI capabilities directly into bash and zsh shells for MacOS and Linux. It allows users to prompt language models with context from their shell history and command output, generate commands, debug errors, and run AI agents. The tool is open source under the MIT license and is aimed at people who work from the command line with a bent toward software engineering.

• Integrates AI prompting into bash and zsh shells by intercepting shell input and output
• Allows users to send a prompt to ChatGPT simply by starting a command with a capital letter
• Manages shell and prompting history by injecting recent history and shell output into the chat context
• Provides GPT autosuggestions for terminal commands which can be applied with the Tab key
• Includes Goal Mode, allowing an agent to execute commands to reach a goal either with confirmation or automatically
• Features transparent and editable prompt wrappers kept in a local configuration file
• Supports selecting different models such as gpt-4-turbo or gpt-3.5-turbo, or pointing to OpenAI-compatible APIs
• Includes a Neovim plugin and specific command-line utilities for summarizing text and managing local file embeddings

Pros

• Eliminates copy-pasting by providing high-context AI help directly inside the terminal shell
• Maintains conversation history and includes recent shell output so users can ask contextual follow-up questions
• Offers transparency into underlying AI instructions with visible and editable prompt wrappers
• Supports custom model endpoints through base URL flags for local models or OpenAI-compatible alternatives

Cons

• Goal Mode is described by its documentation as pretty hit or miss
• Requires users to supply their own OpenAI API secret key or compatible API endpoint
• Limited to MacOS and Linux operating systems
• Requires manual configuration and installation via Go or Homebrew

Butterfish fits software engineers, developers, and technical users who spend a significant amount of time working inside the command line and want direct AI assistance without switching windows. It is a poor fit for users who do not use bash or zsh, work exclusively on Windows, or prefer graphical user interfaces over terminal workflows.

The listing states the product is free and open source under the MIT license. Users must supply their own API key, such as an OpenAI account key.

Unlike standard graphical ChatGPT interfaces or web applications, Butterfish operates entirely inside the terminal by intercepting bash and zsh shell sessions. Compared to black-box AI tools, it exposes its underlying instruction wrappers in a local configuration file and injects live shell history and command outputs directly into the AI context.