AI-fix：失敗したコマンドを一言で修正

AI-fix は、ターミナルでのコマンド実行時に発生するエラーを、わずか一言の入力で自動修復する画期的なツールです。従来、コマンドが失敗すると、エラーメッセージをコピーしてブラウザで検索し、Stack Overflow の複数の回答を読み比べて適切な修正コマンドを見つけ出す必要がありました。このプロセスは時間がかかり、作業の流れを中断させます。AI-fix はこの問題を解決するために設計されました。

AI-fix の動作は4つのステップで構成されています。まず、失敗したコマンドを再実行し、標準出力と標準エラー出力をキャプチャします。次に、エラー情報とシステムコンテキスト（OS、Python や Node.js のバージョン、package.json や pyproject.toml などのプロジェクト設定ファイルのリスト）を AI モデルに送信します。デフォルトでは Anthropic の Claude Haiku（高速かつ低コスト）が使用され、必要に応じて OpenAI の GPT-4o-mini も選択可能です。AI は分析結果に基づいて、信頼度スコア付きの構造化された修正コマンドを返します。最後に、AI-fix が修正コマンドを実行し、元のコマンドを再実行して問題が解決したことを確認します。

AI-fix が対応できるエラーシナリオは多岐にわたります。Python でモジュールが見つからない場合（例：ModuleNotFoundError: No module named 'fastapi'）は pip install fastapi を提案。npm ビルドで TypeScript コンパイラが見つからない場合（tsc: command not found）は npm install --save-dev typescript と npx tsc を実行。スクリプトに実行権限がない場合は chmod +x deploy.sh、ポートが既に使用中の場合は lsof -ti:8000 | xargs kill -9、Git プッシュが拒否された場合は git pull --rebase origin main と git push、Docker デーモンが起動していない場合は open -a Docker など、状況に応じた適切な修正が行われます。各修正コマンドには信頼度が表示され、緑色（高信頼度）は一般的なエラーで確実な修正、黄色（中信頼度）は環境に依存する可能性がある修正、赤色（低信頼度）は適用前にユーザーが確認すべき修正であることを示します。

コスト面では、AI-fix は非常に経済的です。Claude Haiku を使用した場合、1回の修正にかかる費用は約0.0003ドルで、3000回の修正でようやく1ドルを消費します。使用オプションも豊富で、直前の失敗コマンドを修正する基本的な使い方に加え、ai-fix python app.py のようにコマンドを指定して実行・修正することも可能です。--dry-run オプションで修正内容を事前に確認でき、-y で確認プロンプトをスキップ、-v で詳細なエラー出力を表示できます。

プライバシーは最優先事項です。AI-fix が送信する情報は、失敗したコマンド、エラー出力（3000文字に切り詰められます）、OS、言語バージョン、プロジェクトファイル名のリストのみです。ファイルの内容、環境変数、API キー、現在のディレクトリ名以外のパス情報は決して送信されません。すべての通信は API 経由で行われ、データは保存されません。

シェル履歴のサポートは広範囲に及み、zsh（~/.zsh_history）、bash（~/.bash_history）、fish（~/.local/share/fish/fish_history）から最後のコマンドを読み取ります。インストールは pip install ai-fix を実行し、ANTHROPIC_API_KEY または OPENAI_API_KEY 環境変数を設定するだけです。Python 3.11 以上が必要で、MIT ライセンスのもとで公開されています。

AI-fix は、開発者がターミナル内で作業を続けながらエラーを修正できるようにすることで、生産性を大幅に向上させます。ブラウザへのコンテキストスイッチを排除し、「ai-fix」と入力するだけで問題解決への道が開かれます。