Butterfish - A shell with AI superpowers

Butterfish A shell with AI superpowers

Paid

#Shell wrapper
#command line
#openai
#ChatGPT
#Goal Mode
#Autosuggest

What is Butterfish?

Butterfish is a shell wrapper designed for individuals who frequently work from the command line. It adds AI prompting capabilities to your existing shell (bash or zsh) through integration with OpenAI (or compatible APIs). This allows for a more intuitive and efficient workflow.

Butterfish functions by intercepting shell input and output. It forwards most commands directly to the shell. However, by starting a command with a capital letter, users can engage the AI prompting feature. The AI considers the shell history, allowing for contextual queries such as asking for explanations of command failures. Butterfish effectively brings the power of AI directly into your terminal, streamlining debugging, command generation, and general information retrieval.

Features

Capital Letter Prompting: Initiate AI prompts by starting a command with a capital letter.
Shell History Awareness: The AI considers the shell history for contextual responses.
GPT Autosuggest: Receive command suggestions, similar to Github Copilot, based on history and current input.
Goal Mode: Engage an AI agent to execute commands towards a specified goal (triggered by ! or !!).
Transparent Prompts: View and customize the prompts sent to the AI model.
Customizable Model Selection: Choose different OpenAI models or use compatible APIs.
Neovim Plugin: Integrate LLM prompting within Neovim for code editing.
Multiple Utility Tools: It Includes command line utilities for prompting, generating commands, summarizing text, and managing embeddings.

Use Cases

Debugging failed commands.
Generating commands for specific tasks.
Getting contextual help within the shell.
Automating tasks with Goal Mode.
Summarizing files.
Generating code within Neovim.
Managing and searching through embeddings of local file

FAQs

What is Butterfish Shell?

Butterfish Shell is a command-line tool that adds AI prompting to your shell (bash, zsh) using OpenAI, allowing for contextual AI help and command suggestions.
How to install Butterfish?

You can use Homebrew on MacOS `brew install bakks/bakks/butterfish` command, or Go install `go install github.com/bakks/butterfish/cmd/butterfish@latest` command.
How does Goal Mode work?

Goal Mode allows an AI agent to execute commands to reach a specified goal. Start a command with '!' to have the agent suggest commands, or '!!' to allow it to execute commands without confirmation.
How to change used model?

You can configure it for other models like `butterfish shell -m gpt-3.5-turbo` command.
How does Butterfish Shell Work?

When you run butterfish shell in your terminal it starts an instance of your shell (e.g. /bin/zsh), then intercepts the shell’s input and output. This is why we call it a “shell wrapper”.