butterfish

butterfish 是一款革命性的開源工具，專為開發者、系統管理員以及所有在命令列環境中工作的用戶設計。它作為一個智慧的 shell 包裝器，適用於 bash 和 zsh，將 OpenAI GPT 系列等大型語言模型 (LLM) 的強大功能無縫整合到您的終端機工作流程中。butterfish 常被譽為「命令列的 GitHub Copilot」，它透過提供上下文感知的 AI 輔助、命令生成和自動化功能，極大地增強了您的命令列體驗，而這一切都無需離開您的終端機。

butterfish 的核心理念是其直觀且無侵入式的整合方式。您可以像往常一樣使用您的 shell，但現在擁有了一項超能力：只需以大寫字母開始任何命令，即可將其轉換為對 AI 的提示。AI 能夠存取您最近的 shell 歷史記錄，從而理解您的工作上下文。這使您能夠提出後續問題、偵錯失敗的命令，並獲得與當前任務高度相關的建議，徹底告別了將錯誤訊息複製貼上到搜尋引擎的繁瑣循環。

如何使用 butterfish

開始使用 butterfish 非常簡單。它專為 macOS 和 Linux 環境設計。

1. 安裝： 您可以在 macOS 上使用 Homebrew (brew install bakks/bakks/butterfish) 或使用 Go (go install github.com/bakks/butterfish/cmd/butterfish@latest) 輕鬆安裝 butterfish。
2. 身份驗證： 首次執行時，butterfish 會提示您輸入 OpenAI API 金鑰。您需要從您的 OpenAI 帳戶生成一個金鑰並貼上。該金鑰將本地儲存在 ~/.config/butterfish/butterfish.env 檔案中。
3. 執行 Shell： 透過執行 butterfish shell 命令啟動這個由 AI 驅動的 shell。建議在您的 .zshrc 或 .bashrc 檔案中建立一個別名，如 alias bf="butterfish"，以便更快地存取。
4. 向 AI 提問： 在 butterfish shell 中，輸入一個以大寫字母開頭的提示，例如：給我一個指令，尋找所有大於 100MB 的 .log 檔案。AI 將會返回相應的指令。
5. 偵錯： 如果一個指令執行失敗，您可以立即尋求幫助：為什麼上一個指令失敗了？ AI 會結合上下文分析錯誤訊息和您的指令，並提供解釋和修正後的版本。
6. 使用目標模式 (Goal Mode)： 對於更複雜的任務，您可以透過以 ! 開頭的提示來啟動目標模式。例如：!為這個專案安裝 python 依賴並執行測試。AI 將扮演一個代理的角色，逐一建議指令供您執行。使用 !! 則進入不安全的模式，它會無需確認直接執行指令（請謹慎使用）。
7. 自動建議： 在您輸入時，butterfish 會主動建議指令補全，您可以透過按 Tab 鍵來接受。

butterfish 的核心功能

• 上下文感知 AI 輔助： butterfish 會記錄您的指令及其輸出歷史，使 AI 能夠提供與上下文相關的答案和偵錯幫助。
• 無縫 Shell 整合： 它包裝您現有的 shell (bash 或 zsh)，而不會干擾您的自訂配置、別名或函數。
• AI 指令生成與自動建議： 透過自然語言描述生成複雜的 shell 指令，並在您輸入時獲得類似 Copilot 的智慧建議。
• 自主代理（目標模式）： 一項強大的功能，AI 可以執行一系列指令以實現複雜目標，並提供使用者確認和自主執行兩種模式。
• 完全自訂與透明度： 使用者可以查看和編輯傳送給 AI 的系統提示，選擇不同的 LLM 模型（包括透過相容 API 使用的本地模型），並在詳細模式下檢查原始 API 請求。
• 內建實用工具： 包含額外的命令列工具，用於總結文字檔案、生成指令 (gencmd)，以及管理本地檔案的語義嵌入以實現程式碼感知的問答功能 (index, indexsearch)。
• Neovim 整合： 專用的 butterfish.nvim 插件將同樣流暢的 LLM 提示功能直接帶入 Neovim 編輯器，用於程式碼重構等任務。
• 開源： butterfish 採用 MIT 授權，可免費使用、修改和貢獻，從而促進了透明和社群驅動的開發過程。

butterfish 的使用案例

butterfish 功能多樣，可應用於多種場景：

• 學習與探索： 命令列新手可以透過用簡單的英文描述他們想做的事情，來學習像 awk、sed 或 `ffmpeg` 這樣的複雜工具。
• 高效偵錯： 開發者無需再上網搜尋晦澀的錯誤訊息，可以立即獲得解釋和修復方案，從而顯著加快開發週期。
• 複雜指令建構： 對於需要複雜指令鏈的一次性任務，例如根據特定條件尋找、處理和移動檔案，butterfish 可以在幾秒鐘內生成指令。
• 專案建構與自動化： 使用目標模式自動化設定任務，例如複製儲存庫、從 `package.json` 或 `requirements.txt` 安裝依賴，並執行初始建構指令。
• 程式碼庫問答： 透過使用 index 指令索引專案的原始碼，開發者可以提出諸如 indexquestion 資料庫連線字串在哪裡定義的？ 之類的問題，以快速導覽和理解不熟悉的程式碼。

butterfish 的優勢特點

butterfish 的主要優勢在於它能顯著提升生產力和效率。透過將 AI 直接整合到終端機中，它消除了上下文切換，簡化了工作流程。它為新手和專家使用者都提供了強大的支援，使命令列更易於存取和使用。其對透明度和可自訂性的承諾，允許使用者根據自己的特定需求自訂工具並信任其操作。最後，作為開源專案，它確保了它將繼續是一個免費的、由社群支援的、並隨使用者回饋不斷發展的工具。

定價和計劃

butterfish 本身是一個完全免費的開源工具，基於 MIT 授權提供。使用該軟體無需支付任何訂閱費或費用。然而，為了正常工作，butterfish 需要一個 LLM 供應商的 API 金鑰，預設為 OpenAI。使用者需要自行承擔其 API 使用所產生的費用。成本取決於所選模型和使用頻率（例如，自動建議功能會消耗更多的 API）。該工具提供了管理成本的選項，例如調整自動建議的逾時時間、停用它或使用更經濟的模型。