butterfish-shell
Butterfish Shell is an AI-powered command line shell wrapper that integrates OpenAI's GPT models to provide contextual command suggestions, debugging help, and goal-oriented automation directly within bash or zsh shells on MacOS and Linux.
butterfish-shell is developer tools software teams evaluate for developer tools. Use this page to review pricing, integration signals, and the best alternatives before you commit.
Used in These Packs
Quick Overview
Best for: Developer Tools
What it does
Developer Tools software for decision-makers comparing workflow fit and alternatives.
Best fit
Developer Tools
Pricing snapshot
Free
Next step
Compare butterfish-shell with similar tools before you shortlist it.
Compare this tool before you shortlist it
Review alternatives, pricing posture, and workflow fit side by side.
butterfish-shell
Butterfish Shell is designed for command line users who want to enhance their shell experience with AI assistance. It wraps existing shells like bash and zsh, enabling users to start commands with a capital letter to prompt AI-powered suggestions, explanations, and debugging help using OpenAI's GPT models. The AI has access to the shell history, allowing contextual conversations such as understanding why a command failed or generating new commands. It also supports a Goal Mode where the AI acts as an agent to execute commands to achieve user-defined goals. Butterfish is open source, configurable, and aims to be unobtrusive while improving productivity for developers and command line users.
AI-powered command-line tool for shell prompting and autocompletion.
Own this listing?
Claim this page to add pricing, features, screenshots, and verified owner details.
Claim this listingKey Features
AI-Powered Command Prompting
Start commands with a capital letter to send prompts to OpenAI's GPT models, receiving contextual help and command generation based on shell history.
Goal Mode
An agent mode where the AI suggests and optionally executes commands to accomplish user goals, with options for safe or unsafe execution.
Autosuggest
GitHub Copilot-like autosuggestions for shell commands based on recent history and AI-generated completions, applied with the Tab key.
Customizable Prompts
Users can edit the prompt wrappers in a YAML configuration file to control the instructions sent to the AI.
Multi-Model Support
Supports different OpenAI models like gpt-4-turbo and gpt-3.5-turbo, and can connect to any OpenAI-compatible API endpoint.
Shell Integration
Works seamlessly with bash and zsh on MacOS and Linux, intercepting shell input/output without interfering with normal workflows.
Verbose Logging and Transparency
Enables verbose mode to log full AI prompts and responses for transparency and debugging.
Neovim Plugin
Includes butterfish.nvim plugin for fluent LLM prompting within Neovim.
Pricing
Butterfish itself is open source and free to use, but requires an OpenAI API key which may incur costs depending on your OpenAI subscription and usage.
Use Cases
Contextual Command Debugging
Ask why a previous shell command failed and get AI explanations and fixes without leaving the terminal.
Command Generation
Request AI to generate shell commands for specific tasks, such as finding files or installing dependencies.
Goal-Oriented Automation
Use Goal Mode to have the AI suggest and execute sequences of commands to accomplish complex tasks.
Shell Autocompletion
Receive AI-powered autosuggestions for commands as you type, improving efficiency and reducing errors.
General ChatGPT Interface
Use the shell as a ChatGPT interface for non-shell related queries, like asking for recipes.
Neovim Code Rewriting
Use the butterfish.nvim plugin to prompt LLMs for code rewriting and other programming tasks inside Neovim.
Integrations
OpenAI API
Uses OpenAI's ChatGPT API for AI-powered command suggestions and interactions.
OpenAI-Compatible APIs
Supports any server with an OpenAI-compatible API endpoint, enabling use with local or alternative AI models.
Neovim
Provides a Neovim plugin (butterfish.nvim) for LLM prompting inside the editor.
Benefits
Limitations
Frequently Asked Questions
What shells does Butterfish support?
How do I prompt the AI in Butterfish Shell?
What is Goal Mode?
Is Butterfish free to use?
Can I customize the AI prompts?
Does Butterfish interfere with normal shell usage?
Getting Started
- 1 Install Butterfish Shell via Homebrew on MacOS or using 'go install' on MacOS/Linux.
- 2 Run 'butterfish shell' to start the shell wrapper.
- 3 On first run, provide your OpenAI API key when prompted.
- 4 Optionally alias 'butterfish' to a shorter command like 'bf' in your shell config.
- 5 Start using AI prompts by typing commands starting with a capital letter.
- 6 Explore Goal Mode by starting commands with '!' or '!!' for agent-driven automation.
Support
docs
Documentation and usage instructions are available on the GitHub repository.
issue tracker
Users can submit issues and feature requests via the GitHub repository at https://github.com/bakks/butterfish.
API
Butterfish uses the OpenAI ChatGPT API and supports any OpenAI-compatible API endpoint configurable via the --base-url flag.
Butterfish respects OpenAI API token limits (e.g., 4096 tokens for GPT-3.5) and truncates shell history accordingly to fit requests.
Compare butterfish-shell with similar tools
See how it stacks up against alternatives
Related Tools
View all 127 →future-agi
FutureAGI is a comprehensive AI agent engineering and optimization platform designed to help enterprises achieve up to 99% accuracy in AI applications across software and hardware, offering tools for evaluation, optimization, monitoring, and protection of AI models.
gitstart-ai-ticket-studio
GitStart's Ticket Studio transforms vague tickets into detailed, actionable specs with clear context, enabling coding agents and developers to deliver high-quality, merge-ready pull requests efficiently.
Claude Sonnet 4.5
Claude Sonnet 4.5 is a state-of-the-art AI coding model designed for building complex agents and using computers effectively. It excels in reasoning, math, and long-duration autonomous coding tasks, making it ideal for developers, researchers, and professionals in finance, law, medicine, and STEM fields.
imandra-ai
Imandra AI offers CodeLogician™, an agentic governance platform that applies neurosymbolic AI to enhance AI coding assistants with rigorous logical reasoning, enabling trustworthy, verifiable software development beyond statistical methods.
Hugging Face
Hugging Face is a collaborative AI platform and community focused on building the future of machine learning by sharing models, datasets, and applications. It offers tools, open-source libraries, and enterprise solutions to accelerate AI development.
Premium Alternatives
Mubert
Mubert is a generative-AI music platform offering royalty-free, customizable music via subscriptions, perpetual licenses and an API. It provides tools for creators, streamers and developers to integrate procedurally generated tracks and license certificates for commercial use under plan terms.
actionize-ai
Actionize is a no-code platform that enables users to connect custom GPTs to thousands of apps via popular automation tools like Zapier and Make.com, simplifying the integration of external data and workflows into GPTs.
SoundSoReal
SoundSoReal is an AI voice design platform that enables creators, marketers, and entrepreneurs to create 100% unique, human-like voices using simple prompts, voice cloning, remixing, and multilingual translation. It offers full creative control and affordable one-time pricing for producing cinematic narrations, podcasts, audiobooks, and more.
generate-ads-ai
Generate Ads AI is an AI-powered tool that creates scroll-stopping static ads quickly and easily, allowing users to generate ads from scratch or clone winning ads from a large inspiration library. It supports over 30 languages and is designed for marketers, agencies, and businesses seeking efficient ad creation without the need for design expertise.