Repolode
提交项目
Realiserad

Realiserad/fish-ai

一款 Fish 终端插件，借助大语言模型实现注释与命令互转、修复错误命令和智能补全。

在 GitHub 查看
Star
566
Fork
52
未关闭 Issue
1
最近提交
前天

这是什么？

fish-ai 是一款为 Fish 终端添加大语言模型能力的插件。输入以 # 开头的注释后按快捷键，即可生成对应的 shell 命令；反过来，输入一条命令也能得到解释它功能的注释。这对 git、kubectl、curl 等参数繁多的工具尤其有用。

插件还能在命令出错后给出修复建议，并提供命令或注释的自动补全。补全结果会在内置的 fzf 模糊查找界面中展示，你可以继续输入指令来细化结果。所有操作都通过可自定义的快捷键完成，使用 fisher 安装。

模型后端通过 INI 配置文件设置，支持 Anthropic、OpenAI、Google、AWS Bedrock、Groq、Cohere、OpenRouter 等服务，也支持 Ollama 等兼容 OpenAI 接口的自部署模型。发送给模型的内容包括操作系统名称、当前命令行及相关上下文，并会对以参数形式传入的密码和 API 密钥等敏感信息进行脱敏。

核心功能

  • 01将注释转换为 shell 命令，也可为已有命令生成注释说明。
  • 02在命令执行失败后提供修复建议。
  • 03基于 fzf 的命令自动补全，可通过自然语言指令细化结果。
  • 04支持多家模型服务商，也支持自部署的 OpenAI 兼容接口。
  • 05快捷键可自定义，全程无需鼠标。
  • 06可设置解释使用的语言，并支持自定义 HTTP 请求头。

适用场景

  • 不离开终端即可查询 git、kubectl、curl 等工具的参数用法。
  • 用自然语言描述需求，快速生成一次性的 shell 管道命令。
  • 命令输错或执行失败后，获取修正后的命令。
  • 使用自部署模型，让命令行上下文保留在本地机器上。

快速上手

  1. 1

    安装 git，以及 uv，或受支持版本的 Python（需包含 pip 和 venv）

  2. 2

    使用 fisher 安装插件

    fisher install realiserad/fish-ai
  3. 3

    创建配置文件 ~/.config/fish-ai.ini，并填写你选择的语言模型服务商

使用前须知

  • 需要托管模型服务商的 API 密钥，或自行部署的模型。
  • 会将你的命令行、操作系统名称以及相关命令输出或文件内容发送给语言模型。

收录于专题

本地运行大模型命令行与终端工具

标签

#fish#shell#llm#command-line#autocomplete#terminal#ollama#fish-plugin#fisher

常见问题

fish-ai 是什么？
一款 Fish 终端插件，借助大语言模型实现注释与命令互转、修复错误命令和智能补全。 fish-ai 是一款为 Fish 终端添加大语言模型能力的插件。输入以 # 开头的注释后按快捷键，即可生成对应的 shell 命令；反过来，输入一条命令也能得到解释它功能的注释。这对 git、kubectl、curl 等参数繁多的工具尤其有用。
fish-ai 可以免费使用吗？用的什么许可证？
fish-ai 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
fish-ai 还在维护吗？
活跃维护中。fish-ai 最近一次提交是在 2026年11月6日。
fish-ai 适合用来做什么？
不离开终端即可查询 git、kubectl、curl 等工具的参数用法。 用自然语言描述需求，快速生成一次性的 shell 管道命令。 命令输错或执行失败后，获取修正后的命令。 使用自部署模型，让命令行上下文保留在本地机器上。
fish-ai 怎么安装和运行？
安装 git，以及 uv，或受支持版本的 Python（需包含 pip 和 venv） 使用 fisher 安装插件: fisher install realiserad/fish-ai 创建配置文件 ~/.config/fish-ai.ini，并填写你选择的语言模型服务商
在哪里获取 fish-ai？
源代码和安装说明在 GitHub 上：https://github.com/Realiserad/fish-ai

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目