Butterfish Shell
Click to visit website
About
Butterfish is an open-source command line tool written in Go that acts as a shell wrapper for bash and zsh on macOS and Linux. By intercepting shell input and output, it provides a seamless interface for interacting with large language models without requiring users to copy-paste terminal text into a browser. Its primary innovation is a unique UX pattern where users can trigger AI prompts simply by starting a command with a capital letter. Because the tool maintains a buffer of recent terminal history, the AI has full context of previous commands and errors, allowing for natural-language troubleshooting like asking why a specific command failed. The tool features a dedicated "Goal Mode," which functions as an autonomous agent within the terminal. By prefixing a prompt with an exclamation point, users can task the AI with accomplishing specific objectives, such as recursively finding and deleting hidden files or debugging a build process. The agent suggests commands that the user can execute with a single keystroke, or in "Unsafe Goal Mode," it can execute them automatically. Beyond the shell wrapper, Butterfish includes a suite of CLI utilities for semantic text summarization, command generation, and RAG-style local file indexing. This allows users to create embeddings of local directories and ask the AI specific questions based on their own codebases or documentation. Butterfish is designed primarily for software engineers, system administrators, and power users who spend significant time in the terminal. It differentiates itself from other terminal-AI integrations through its transparency and extensibility. Users have full control over the underlying system prompts via a local configuration file and can view the exact JSON requests being sent to the API. While it defaults to OpenAI models like GPT-4 Turbo, it is provider-agnostic and can be configured to point toward any local or remote server that provides an OpenAI-compatible API endpoint. Technically, the tool manages the terminal's state by injecting hidden ANSI escape codes and status codes into the shell prompt, which signals to the wrapper whether a command succeeded or failed. It carefully monitors child processes, such as text editors or SSH sessions, to ensure the AI does not interfere with interactive applications. By combining real-time shell context with vector-based file search and autonomous agent capabilities, Butterfish attempts to turn the standard Unix terminal into a fully AI-integrated development environment.
Pros & Cons
Eliminates the need for copy-pasting terminal output into external AI chats.
Provides deep context by sending recent shell history and status codes to the LLM.
Highly transparent with visible, editable system prompts in a YAML configuration.
Supports local LLMs via configurable API endpoints for improved privacy.
Lightweight Go implementation that integrates with existing terminal customizations.
Goal Mode can be unreliable and is described by the developer as 'hit or miss'.
Autosuggestion features can become expensive if used frequently with paid APIs.
Primary functionality is currently limited to macOS and Linux environments.
Unsafe Goal Mode (!!) can execute dangerous commands without user confirmation.
Use Cases
Software developers can debug compiler errors in real-time by asking the AI for fixes based on the immediate error output.
System administrators can automate file management tasks by using Goal Mode to find and process files across complex directory structures.
DevOps engineers can use the local indexing feature to query documentation and codebases directly from the command line.
Power users can generate complex shell commands from natural language without leaving the terminal environment.
Neovim users can leverage the dedicated plugin to rewrite code blocks using fluent LLM prompting inside their editor.
Platform
Task
Features
• neovim integration plugin
• openai-compatible api support
• semantic file summarization
• context-aware command autosuggest
• local file embedding and indexing
• autonomous goal mode agent
• capital-letter prompt triggering
• shell wrapper for bash and zsh
FAQs
How do I trigger an AI prompt in the shell?
You can send a prompt to the AI by starting any command with a capital letter while inside the Butterfish shell. The tool intercepts these inputs and sends them to the configured LLM along with your recent terminal history for context.
Does Butterfish work with local LLMs?
Yes, Butterfish can be used with local models by using the --base-url flag to point to any OpenAI-compatible API. This allows you to run models through tools like LocalAI or Ollama instead of relying on the cloud.
Is an OpenAI API key required to use the tool?
While the Butterfish software itself is free and open-source, it requires an API key for the models it uses. You must provide your own OpenAI secret key or a compatible alternative to enable the AI features.
What is Goal Mode and how do I use it?
Goal Mode is an agentic feature triggered by starting a command with an exclamation point. The AI will attempt to solve a complex task by suggesting and refining commands based on the success or failure of previous steps.
Can Butterfish see my local files?
Butterfish includes an indexing command that creates local embeddings of your files. This allows the AI to perform semantic searches and answer questions based on the specific content of your project directories.
Pricing Plans
Open Source
Free Plan• MIT License
• Bash and Zsh support
• Goal Mode (Agent)
• Local file indexing
• Neovim plugin
• Customizable prompts
• Local LLM support
• Command autocomplete
• Text summarization
• Contextual debugging
Job Opportunities
There are currently no job postings for this AI tool.
Ratings & Reviews
No ratings available yet. Be the first to rate this tool!
Featured Tools
adly.news
Connect with engaged niche audiences or monetize your subscriber base through an automated marketplace featuring verified metrics and secure Stripe payments.
View Details
Reztune
Land more interviews by instantly tailoring your resume to any job description using AI-driven keyword optimization and professional, ATS-friendly templates.
View Details
Image to Image AI
Transform photos and videos using advanced AI models for face swapping, restoration, and style transfer. Perfect for creators needing fast, professional visuals.
View Details
Nano Banana
Edit and enhance photos using natural language prompts while maintaining character consistency and scene structure for professional marketing and digital art.
View Details
Nana Banana Pro
Maintain perfect character consistency across diverse scenes and styles with advanced AI-powered image editing for creators, marketers, and storytellers.
View Details
Kling 4.0
Transform text and images into cinematic 1080p videos with multi-shot storytelling, character consistency, and native lip-synced audio for professional creators.
View Details
AI Seedance
Generate 15-second cinematic 2K videos with physics-based audio and multi-shot narratives from text or images. Ideal for creators and marketing teams.
View Details
Mistrezz.AI
Engage in immersive NSFW roleplay and ASMR voice sessions with adaptive AI companions designed for structured escalation, fantasy scenarios, and personal connection.
View Details
Seedance 3.0
Transform text prompts or static images into professional 1080p cinematic videos. Perfect for creators and marketers seeking high-quality, physics-aware AI motion.
View Details
Seedance 3.0
Transform text descriptions into cinematic 4K videos instantly with ByteDance's advanced AI, offering professional-grade visuals for creators and marketing teams.
View Details
Seedance 2.0
Generate broadcast-quality 4K videos from simple text prompts with precise text rendering, high-fidelity visuals, and batch processing for content creators.
View Details