ascorbic/am-i-vibing

解決する課題

am-i-vibing は、ソフトウェアツールや Node.js アプリケーションが AI エージェントや AI 駆動のコーディング環境（Cursor、Replit、Claude Code など）によって実行されているかどうかを検出するために設計されたライブラリおよび CLI ツールです。これにより、開発者は AI が主なユーザーである場合に、ツールの動作を適応させることができます。例えば、構造化されたログや LLM に最適化されたエラーメッセージを提供するなどです。

仕組み

このツールは主に、AI プロバイダーによって公開された特定の環境変数をチェックすることで AI 環境を特定します。また、環境変数を提供しないツールを特定するために親プロセスチェーン（プロセスツリー検出）を検査することもオプションで可能ですが、パフォーマンス上の理由からデフォルトでは無効になっています。

対象者

AI エージェントやエージェント的なコーディング環境に合わせて出力を最適化したいと考えている、CLI ツールや Node.js アプリケーションを開発する開発者。

ハイライト

• 幅広いサポート: Aider、Bolt、Claude Code、Cursor、GitHub Copilot Agent、Replit、Windsurf、Zed などの幅広いツールを検出します。
• 環境分類: 環境を Agent（直接の AI 制御）、Interactive（AI 駆動のシェル）、Hybrid の 3 種類に分類します。
• 柔軟な統合: プログラム可能なライブラリと JSON 出力をサポートする CLI ツールの両方として利用可能です。
• オプトインのプロセス検出: 環境変数を持たないプロバイダーに対してプロセスツリーの詳細な検査を可能にします。