butterfish-shell

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.

Free API
#132 in Developer Tools (132 tools)
Added 0 year ago
29866 directory views this week

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 listing

Key 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

Free Tier Available

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

Improves command line productivity with AI-powered contextual assistance.
Reduces the need to switch contexts or copy-paste between terminal and browser.
Customizable and transparent AI prompts for user control and trust.
Supports multiple AI models and local OpenAI-compatible endpoints.
Open source and actively maintained with community feedback.
Seamless integration with existing shells without disrupting workflows.

Limitations

Goal Mode can be hit or miss and may struggle with complex or large file manipulations.
AI suggestions depend on the quality and recency of shell history within token limits.
Requires an OpenAI API key and usage may incur costs.
Unsafe Goal Mode (!!) can execute commands without confirmation and should be used with caution.
History and command outputs are truncated to fit within API token limits, limiting context size.

Frequently Asked Questions

What shells does Butterfish support?
Butterfish supports bash and zsh shells on MacOS and Linux.
How do I prompt the AI in Butterfish Shell?
Start your command with a capital letter to send it as a prompt to the AI.
What is Goal Mode?
Goal Mode allows the AI to suggest and optionally execute commands to accomplish a user-defined goal, triggered by starting a command with '!' or '!!'.
Is Butterfish free to use?
Butterfish is open source and free, but requires an OpenAI API key which may have associated costs.
Can I customize the AI prompts?
Yes, prompts are stored in a YAML file (~/.config/butterfish/prompts.yaml) and can be edited to customize AI behavior.
Does Butterfish interfere with normal shell usage?
Butterfish is designed to be unobtrusive and does not interfere with normal shell workflows, except for adding a prompt emoji and intercepting input starting with capital letters.

Getting Started

  1. 1 Install Butterfish Shell via Homebrew on MacOS or using 'go install' on MacOS/Linux.
  2. 2 Run 'butterfish shell' to start the shell wrapper.
  3. 3 On first run, provide your OpenAI API key when prompted.
  4. 4 Optionally alias 'butterfish' to a shorter command like 'bf' in your shell config.
  5. 5 Start using AI prompts by typing commands starting with a capital letter.
  6. 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

Available: Yes
Documentation:

Butterfish uses the OpenAI ChatGPT API and supports any OpenAI-compatible API endpoint configurable via the --base-url flag.

Rate Limits:

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 132 →
Contact for pricing
gapier-free-gpts-actions-apis

gapier-free-gpts-actions-apis

Gapier offers free actions and APIs designed for ChatGPT users, enabling custom GPTs and enhanced ChatGPT actions to improve user interaction and automation.

Developer Tools
Free
v0

v0

v0 by Vercel is a platform offering a wide range of modern, customizable web application templates and components built with Next.js, React, and TypeScript. It enables developers and startups to quickly build, deploy, and customize web apps with responsive designs, smooth animations, and integrations with services like BaseHub and Supabase.

Developer Tools Engineering & Development
Free
awan-llm

awan-llm

Awan LLM is a cost-effective, unlimited token LLM inference API platform designed for power users and developers, offering unrestricted access to large language models without censorship or token limits.

Developer Tools
Free
AI Elements by Vercel

AI Elements by Vercel

Vercel provides developer tools and cloud infrastructure to build, scale, and secure fast, personalized web experiences on the AI Cloud, enabling rapid deployment and optimized performance for AI-powered applications.

Developer Tools AI Infrastructure Tools
Contact for pricing
gitstart-ai-ticket-studio

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.

Developer Tools
Contact for pricing
sre-ai

sre-ai

SRE.ai is an AI-powered platform designed to unify DevOps workflows, automate reliability, and accelerate innovation for modern enterprise software teams, with a focus on seamless collaboration, error prevention, and safe deployments.

Developer Tools
Paid
Usesaaskit

Usesaaskit

useSAASkit is a Next.js and React Native AI-focused SaaS boilerplate that provides authentication, multi-organization support, admin tools, billing, marketing pages, analytics, and built-in AI integrations to help makers launch AI apps quickly.

Developer Tools
Contact for pricing
create-api.dev by Kong

create-api.dev by Kong

create-api.dev by Kong is an AI-powered tool that generates high-quality OpenAPI specifications quickly, enabling users to share, test, and ship API specs efficiently.

Developer Tools AI

Premium Alternatives

Paid
Outgrw

Outgrw

FastReach 2.0 (by Outgrw) is a step-by-step LinkedIn outreach program that teaches founders and service-based providers a repeatable system to book high-ticket sales calls using tested targeting, messaging, profile credibility fixes, and automation.

Sales
Paid
Prophotos

Prophotos

ProPhotos is a professional AI headshot generator that creates photorealistic, industry-specific headshots from your casual photos in minutes, serving individuals and enterprises with scalable packages and commercial usage rights.

Image & Design
Paid
Veo-3

Veo-3

Veo 3 is an AI video generator powered by Google DeepMind's Veo 3 model with V2A technology, producing professional, broadcast-quality videos with synchronized audio and dialogue from text or image prompts in seconds.

Video Generation
Paid
genads

genads

GenAds is a dynamic catalog ads platform that enables businesses to quickly create and optimize high-converting ads and creatives for their entire product catalog, integrating seamlessly with Meta and Shopify.

Marketing
Paid
Pixly

Pixly

Pixly.app is an AI-powered platform that transforms a few selfies into professional-quality photos, speaking videos, and customizable AI influencers. It targets creators, professionals, and brands seeking fast, photorealistic content without hiring a photographer.

Image & Design
Paid
cannypen

cannypen

CannyPen is an AI-powered content creation platform offering a wide range of tools including AI writing, voiceovers, image generation, and code writing to help users create high-quality content quickly and efficiently.

Writing & Text
Paid
Battery Life and Health

Battery Life and Health

Battery Life and Health is a Mac utility app that provides a clean, space-saving battery indicator showing charge level and remaining time, along with battery health and hardware info for MacBook devices.

Productivity Productivity
Paid
cospec

cospec

cospec is a no-code platform that enables users to write workflows in an IDE and deploy unified MCP servers for AI agents, connecting various data sources and automating tasks securely and efficiently.

NoCode / LowCode AI Infrastructure

Explore Related Categories

Explore by Outcome