Repolode
Realiserad

Realiserad/fish-ai

LLMでコメントからコマンドを生成し、コマンドの説明や誤入力の修正、コマンドラインの補完を行うFish shellプラグイン。

スター
566
フォーク
52
未解決の Issue
1
最終コミット
一昨日

これは何?

fish-aiは、コマンドラインから言語モデルを利用できるFish shellプラグインです。タスクの説明などをコメントとして入力し、ショートカットキーを押すとシェルコマンドを生成できます。逆に、コマンドを入力して、その動作を説明するコメントを得ることもできます。git、kubectl、curlのようにフラグが多いツールを使うときに便利です。

コマンドが失敗したときに修正案を提示するほか、コマンドやコメントの補完にも対応しています。候補は同梱のfzfファジーファインダーに表示され、追加の指示で絞り込めます。すべて設定可能なキーボードショートカットから実行でき、インストールにはfisherを使います。

モデルのバックエンドはINI形式の設定ファイルで指定します。Anthropic、OpenAI、Google、AWS Bedrock、Groq、Cohere、OpenRouterなどのプロバイダーに加え、OllamaのようなOpenAI互換のセルフホストサーバーにも対応しています。プラグインはOS名、コマンドバッファー、関連するコンテキストをモデルに送信し、引数として渡されたAPIキーなど、一部の機密情報はマスキングします。

主な機能

  • 01コメントからシェルコマンドを生成し、既存のコマンドを説明するコメントを作成します。
  • 02失敗したコマンドの修正案を提示します。
  • 03指示で候補を絞り込める、fzfベースのピッカーでコマンドを補完します。
  • 04セルフホストのOpenAI互換サーバーを含む、多数のプロバイダーに対応しています。
  • 05キーボードショートカットを設定でき、マウスは不要です。
  • 06説明に使う言語を設定でき、カスタムHTTPヘッダーにも対応しています。

ユースケース

  • ターミナルを離れずにgit、kubectl、curlのフラグを調べる。
  • 自然言語で説明して、その場限りのシェルパイプラインを作成する。
  • 誤入力や失敗したコマンドの原因を調べ、修正版を得る。
  • セルフホストモデルを使い、コマンドのコンテキストを自分のマシン内にとどめる。

クイックスタート

  1. 1

    gitと、uvまたはpipとvenvに対応したPythonをインストールします

  2. 2

    fisherでプラグインをインストールします

    fisher install realiserad/fish-ai
  3. 3

    使用する言語モデルプロバイダーを設定したファイル ~/.config/fish-ai.ini を作成します

使う前に知っておきたいこと

  • ホスト型モデルプロバイダーのAPIキー、またはセルフホスト型モデルが必要です。
  • コマンドライン、OS名、および関連するコマンド出力やファイルの内容が言語モデルに送信されます。

収録されている特集

トピック

よくある質問

fish-ai とは?
LLMでコメントからコマンドを生成し、コマンドの説明や誤入力の修正、コマンドラインの補完を行うFish shellプラグイン。 fish-aiは、コマンドラインから言語モデルを利用できるFish shellプラグインです。タスクの説明などをコメントとして入力し、ショートカットキーを押すとシェルコマンドを生成できます。逆に、コマンドを入力して、その動作を説明するコメントを得ることもできます。git、kubectl、curlのようにフラグが多いツールを使うときに便利です。
fish-ai は無料で使えますか?ライセンスは?
fish-ai は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
fish-ai は今もメンテナンスされていますか?
活発にメンテナンス中。fish-ai の最終コミットは 2026年11月6日 です。
fish-ai は何に使えますか?
ターミナルを離れずにgit、kubectl、curlのフラグを調べる。 自然言語で説明して、その場限りのシェルパイプラインを作成する。 誤入力や失敗したコマンドの原因を調べ、修正版を得る。 セルフホストモデルを使い、コマンドのコンテキストを自分のマシン内にとどめる。
fish-ai のインストール方法は?
gitと、uvまたはpipとvenvに対応したPythonをインストールします fisherでプラグインをインストールします: fisher install realiserad/fish-ai 使用する言語モデルプロバイダーを設定したファイル ~/.config/fish-ai.ini を作成します
fish-ai はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/Realiserad/fish-ai

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト

汎用のコマンドライン向けファジーファインダー。あらゆる入力リストを絞り込み、シェルスクリプトを対話型のターミナルセレクターに変えます。

8.4万+176 今週4118GoMIT活発にメンテナンス更新 9 時間前