
Shell Sage
Dheeraj (dheerajcl), open-source project on GitHub · コーディング
Shell Sage は、自然言語をシェルコマンドに変換し、エラーを診断し、危険なコマンドを実行前に確認するオープンソースの AI ターミナルアシスタントだ。

Shell Sage について
What Is Shell Sage
Shell Sage はターミナルの中で動くコマンドラインツールで、Linux や Unix のコマンド操作を助ける。この Ollama ターミナル AI の売りは、自然言語からコマンドへの変換にある。やりたいことを普段の言葉で書けば、コマンドを組み立ててくれる。コマンドが失敗すれば、エラーを読み取って修正案を出す。ターミナルのエラー診断も、コマンド生成と並ぶ二枚看板の一つだ。プロジェクトはオープンソースで、GitHub にあり、作者が Apache 2.0 ライセンスで公開している。
想定しているのは、ターミナルを日常的に使うが、すべてのオプションやパイプを覚えたくはない人だ。システム管理者がディスク整理を頼めば find コマンドが返ってくる。難解なエラーにぶつかった開発者が何が起きたのか尋ねれば、平易な言葉で説明が返る。コマンドは確認するまで実行されないので、危険に見えるコマンドはファイルに触れる前に警告される。
先に押さえておきたい点が二つある。Shell Sage は Python で動き、Linux と macOS で最も快調に動作し、Windows 対応はまだ限定的だ。動作には言語モデルも必要になる。Ollama 経由でローカルモデルを指定すればデータは手元に残り、Groq、OpenAI、Anthropic といったクラウド事業者を指定すれば速い代わりに問い合わせがネットワークを経由する。
Getting Started
- GitHub からプロジェクトを複製し、Python の依存関係を取得するインストールスクリプトを実行する
- すべて手元で動かすなら Ollama を入れてローカルモデルを取得し、そうでなければクラウド事業者の API キーを用意する
shellsage setupを実行し、ローカルか API のモードを選び、ウィザードでモデルを決めるshellsage askに普段の言葉で依頼を書き、生成されたコマンドを確認してから実行する
AIツール情報
Shell Sageの料金、対応プラットフォーム、性能を簡単に確認できます。
こんな人におすすめ
このツールが最も力を発揮するユーザー、タスク、シーン。
ユーザー
- Linux と macOS の上級者:ターミナルに長く滞在し、コマンドのオプションをいちいち調べたくない人。Python 3.8 以上があれば動く
- システム管理者と DevOps 担当:整理、バックアップ、ログ確認のコマンドをよく打ち、Enter を押す前にもう一段の確認がほしい人
- シェルのエラーを追う開発者:ビルドスクリプトが出す難解なメッセージに悩み、平易な説明と修正案を求める人
- プライバシーを重視する人:AI の助けは欲しいがコマンドをクラウドに送りたくない人。Ollama のローカルモデルで済ませられる
タスク
- 自然言語からコマンドへの変換:「メモリ使用量を見る」「大きいファイルを探す」と書けば使えるコマンドが返る
- エラー診断:失敗したコマンドやエラーメッセージを渡し、説明と修正案を受け取る
- 危険なコマンドの点検:破壊的なコマンドや危険なパスを実行前に警告する
- 複雑な作業:ファイル一式のバックアップのような複数手順を、一度の確認でまとめて実行する
- モデルと事業者の切り替え:ローカルモデルとクラウド事業者を、作業の流れを変えずに切り替える
シーン
- またオプションを忘れた:マニュアルを探し回らず、普段の言葉でコマンドを尋ねる
- 深夜にビルドスクリプトが失敗:エラーを貼り付ければ、ブラウザを開かずに原因の見当がつく
- コマンドが危険に見える:Shell Sage が危険なパスを示し、確認の前に安全な書き方を提案する
- 機密データを扱う:ローカルモデルに切り替えれば、コマンドが端末の外に出ない
- 作業するマシンを変える:ノート PC でもサーバーでも同じアシスタントを使い、必要に応じて事業者を切り替える
主な機能
自然言語からシェルコマンドへ
中核はシェルコマンド生成として働き、一文を使えるコマンドに変える。shellsage ask "find large files over 1GB" と打てば find / -type f -size +1G -exec ls -lh {} \; のような結果が返る。find、grep、awk の組み合わせの正確な文法を覚える必要はない。ターミナルは使うが生活の中心にはしない人にとって、この CLI AI アシスタントが役立つ理由はそこにある。
状況を読むエラー診断
コマンドが失敗すると、Shell Sage はエラーを読み、説明し、修正案を出す。パスの誤りやオプションの書き間違いといったよくある問題を拾い、原因の見当をこちらに推測させずに示す。プロジェクトはこれを、コマンド生成と並ぶ二本柱の機能として挙げている。
安全確認つきの実行フロー
Shell Sage はコマンドを実行前に点検し、損害を与えうるものに印を付ける。絶対パスを削除する依頼なら警告が出て、rm -rf ./important-folder のような安全な書き方が示される。コマンドは確認したあとにしか動かないので、破壊的な操作の主導権はこちらに残る。
ローカルとクラウドのモデル対応
このツールはローカルモデルでもクラウドモデルでも動き、どちらを使うかは設定時に決める。ローカルモードは Ollama を使い、すべてを手元に置くので、私的な作業や機密を扱う場面に向く。クラウドモードは Groq、OpenAI、Anthropic、Fireworks、OpenRouter、DeepSeek につないで速さを取る。速度と品質は事業者によって変わると作者は断っている。
対話式セットアップウィザード
shellsage setup が初回の設定を案内する。ローカルと API のどちらのモードにするかを尋ね、続いてモデルを選ばせる。ローカルの既定候補には llama3:8b-instruct-q4_1、mistral:7b-instruct-v0.3、phi3:mini-128k-instruct があり、API を使う人は事業者を選んでキーを貼り付ける。
実行中のモードとモデル切り替え
設定後は、再インストールせずにモードやモデルを切り替えられる。shellsage config --mode api でクラウド事業者に移り、shellsage config --mode local --model で別のローカルモデルに向けられる。同じコマンドは対話式の切り替えも担うので、一覧から選ぶこともできる。
複数事業者とカスタムモデル
Shell Sage は最初から六つのクラウド事業者に対応し、ウィザードが示すモデルに縛られない。.env ファイルの API_MODEL の値を書き換えれば、事業者が提供する任意のモデルを指定できる。新モデルが出ても、このオープンソース CLI ツールを最新の状態に保てる。
メリットとデメリット
メリット
- Apache 2.0 ライセンスのオープンソースで、コードを読んで改変し、購読なしで使える
- Ollama のローカルモードならコマンドとデータが手元に残り、私的な作業に向く
- 実行前にコマンドを確認し、破壊的なものには印を付けるので、ターミナルに安全確認が一つ増える
- ローカルモードと六つのクラウド事業者を切り替えられ、必要に応じてプライバシーと速度を交換できる
- 無料で使え、実質的な出費は API モードを選んだときの自分のクラウド API 利用料だけ
デメリット
- まだアルファ段階で、Windows 対応が限定的なうえ zsh と fish に既知の問題があり、どの環境でも動く保証はない
- エラー検出が時折誤検知を起こし、問題のないコマンドにも修正案を出すことがある
- API モードは事業者のキーが要り、問い合わせがネットワークを経由するので、完全に私的とは言えない
- ローカルモデルには 4GB 以上のメモリが要り、大きいモデルでは 16GB 以上に達する
- 公開プロジェクトはまだ小さく、執筆時点で GitHub のスターは約 76 で、コミュニティの支援は限られる
よくある質問
Shell Sage はコマンドラインで動くオープンソースの AI ターミナルアシスタントだ。自然言語をシェルコマンドに変換し、エラーを説明して修正案を出し、危険なコマンドを実行前に点検する。Ollama のローカルモデルでも、Groq、OpenAI、Anthropic といったクラウド事業者でも動く。
関連コンテンツ
Shell Sageに関連するツール、スキル、記事を探す。
Shell Sageの代替ツール
Forefront
Forefront · コーディングForefrontはオープンソースAIで構築するためのウェブプラットフォームだ。主要なオープンソース言語モデルを自分のデータで微調整し、性能を評価し、API経由で実行したり、エクスポートして自分でホストしたりできる。クローズドなプラットフォームの手軽さを求めつつ、モデルとデータの所有権にはこだわる開発者が対象だ。
Startkit
StartKit.AI · コーディングStartkitは、AI SaaSとAIラッパー製品を作るためのボイラープレートだ。面倒な部分をあらかじめ配線済みにしたAIスタートアップボイラープレートと考えればいい。認証、StripeとLemon Squeezyの決済、利用制限、トランザクションメール、そしてOpenAI、Anthropic、Groq、Llamaと通信するAI APIスターターキットが含まれる。リポジトリをクローンして価格を設定し、ユーザーが実際にお金を払う部分に取りかかれる。ReactとTailwind上のNext.jsで作られているため、ボイラープレートコードの多くはすでに見慣れたものだ。
Testim
Tricentis · コーディングTestimは、Web・モバイル・Salesforceアプリ向けにエンドツーエンドテストを構築して実行するAIテスト自動化プラットフォームだ。機械学習を頼りに、インターフェースが変わってもテストを安定させ、チームが壊れたセレクターの修正に費やす時間を減らす。今日から使い始められる自動テストツールとしては悪くない。ブラウザで操作を録画してテストを作り、より細かい制御が必要なときはJavaScriptを足す。忙しいQAチームにとって堅実な選択肢である。
