AnswerDotAI/shell_sage

これは何？

主な機能

• 01tmuxペインの履歴を読み取り、直近のコマンドやエラーを踏まえた回答を提示します。
• 02パイプで渡したコマンド出力やファイルの内容を分析できます。
• 03Claude、GPT、Gemini、OpenAI互換APIなど、複数のLLMプロバイダーに対応しています。
• 04コマンド実行に使える、許可リストによる安全対策付きのオプションbashツールを備えています。
• 05ユーザーの許可を得て、ファイルの閲覧、検索、編集を行えます。
• 06やり取りをSQLiteに記録し、提案されたコードブロックをプロンプトに挿入できます。

ユースケース

• 端末履歴を文脈として利用し、シェルコマンドやfind式が失敗した原因を調べる。
• journalctlなどのコマンド出力をツールにパイプで渡し、エラーログの内容を解説してもらう。
• ターミナルで使い慣れないコマンドやフラグ、gitのワークフローを学ぶ。
• ターミナルを離れずに、ファイルの確認や安全なコマンドの実行をアシスタントに依頼する。

クイックスタート

1. 1

   pip を使って PyPI から ShellSage をインストールする

   pip install shell-sage
2. 2

   LLM API キーを設定する（デフォルトは Claude）

   export ANTHROPIC_API_KEY=sk...
3. 3

   テスト用の挨拶を実行して、セットアップが機能することを確認する

   ssage hi

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

• !Anthropic や OpenAI など、有料の LLM プロバイダーの API キーが必要です。
• !tmux 内での使用に最適化されており、ターミナルのコンテキスト全体を利用できるかどうかは tmux の設定に依存します。
• !README のバッジには MIT とありますが、リポジトリのメタデータには Apache-2.0 とあるため、LICENSE ファイルを確認してください。

収録されている特集

トピック

よくある質問

shell_sage とは？

tmuxの端末履歴やパイプで渡した出力を読み取り、シェルコマンドやスクリプトを支援するAIコマンドラインアシスタント。 ShellSageは、`ssage`コマンドで起動するターミナル向けAIアシスタントです。tmuxのワークフロー内で動作し、現在のペイン、または複数のペインの履歴を読み取って、実行したコマンドや問題の原因を把握し、説明や修正済みコマンド、実例を提示します。コマンドの出力やファイルの内容をパイプで直接渡して分析することもできます。

shell_sage は無料で使えますか？ライセンスは？

shell_sage は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

shell_sage は今もメンテナンスされていますか？

活発にメンテナンス中。shell_sage の最終コミットは 2026年10月28日 です。

shell_sage は何に使えますか？

端末履歴を文脈として利用し、シェルコマンドやfind式が失敗した原因を調べる。 journalctlなどのコマンド出力をツールにパイプで渡し、エラーログの内容を解説してもらう。 ターミナルで使い慣れないコマンドやフラグ、gitのワークフローを学ぶ。 ターミナルを離れずに、ファイルの確認や安全なコマンドの実行をアシスタントに依頼する。

shell_sage のインストール方法は？

pip を使って PyPI から ShellSage をインストールする: pip install shell-sage LLM API キーを設定する（デフォルトは Claude）: export ANTHROPIC_API_KEY=sk... テスト用の挨拶を実行して、セットアップが機能することを確認する: ssage hi

shell_sage はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/AnswerDotAI/shell_sage