Butterfish Shell dành cho những người làm việc chủ yếu trên terminal. Cài qua Homebrew hoặc go install rồi chạy butterfish shell sẽ khởi tạo một phiên bản mới của bash hoặc zsh quen thuộc, với công cụ chặn luồng vào ra tiêu chuẩn. Từ đó, một dòng bắt đầu bằng chữ in hoa sẽ được chuyển tới mô hình AI thay vì shell: bạn có thể hỏi "vì sao lệnh đó lại lỗi?" và mô hình nhìn thấy lịch sử gần đây cùng kết quả lệnh để trả lời theo ngữ cảnh. Không cần sao chép qua lại giữa trình duyệt và terminal.
Ngoài tính năng nhắc lệnh, công cụ còn gợi ý lệnh bằng GPT, tương tự GitHub Copilot nhưng nằm trong shell, và bạn nhận bằng phím Tab. Mẫu câu nhắc được để công khai, chỉnh sửa được trong tệp YAML thay vì ẩn đi, nên bạn kiểm soát được nội dung chỉ dẫn gửi cho mô hình. Mô hình cũng tùy biến được: mặc định dùng mô hình OpenAI nhưng cờ base URL cho phép trỏ tới bất kỳ endpoint tương thích OpenAI nào, kể cả máy chủ mô hình chạy cục bộ.
Goal Mode là phần agent. Bắt đầu lệnh bằng ! sẽ giao một mục tiêu cho mô hình, mô hình đề xuất lệnh và bạn xác nhận bằng Enter; bắt đầu bằng !! thì cho phép chạy mà không cần xác nhận. Dự án nói thẳng rằng chế độ này khi được khi không, phù hợp nhất với mục tiêu đơn giản và có hướng dẫn rõ, ví dụ tìm tệp lớn hay liệt kê đệ quy tệp Go. Plugin Neovim đi kèm butterfish.nvim mang trải nghiệm nhắc lệnh tương tự vào trình soạn thảo.
