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）。该工具提供了管理成本的选项，例如调整自动建议的超时时间、禁用它或使用更经济的模型。