Brytlog: 開発者向けAIロガーツール

Brytlog は、開発者やAIエージェントが長大な生ログを扱う際の課題を解決するオープンソースのコマンドラインツールです。任意のコマンドをラップし、その標準出力と標準エラー出力をキャプチャして、Gemini-3-flashのような軽量言語モデルを用いて簡潔な要約を生成します。これにより、時間とトークン消費を大幅に削減できます。

エージェントワークフローにおいて、Brytlog は安価で高速な前処理ツールとして機能します。例えば、Claude Opus 4.8 がメインエージェントとして brytlog python run.py を実行すると、生の出力全体を処理する代わりに（遅く、高コストでコンテキストを肥大化させる）、より安価なモデルが生成した簡潔なレポートのみを受け取ります。安全策として、生ログは保存され、必要に応じてメインエージェントや開発者がアクセスできます（設定で切り替え可能）。安価なモデルでさえ、完全な生ダンプではなく重要な部分のみを受け取るため、さらに時間とコストを節約できます。非エージェントの開発者主導ワークフローでは、Brytlog は開発者が自分で生出力を分析したり、コーディングアシスタントにコピーペーストする手間を省きます。

主な特徴：無料、オープンソース、プラットフォーム/言語/LLMベンダー非依存、最小限のセットアップ（APIキーを用意するかローカルで実行するだけ）、既存コードの変更不要（AGENTS.mdに数行追加するだけでOK）、軽量（約50KB、約1400行）、カスタマイズ可能、プライバシー重視（データを収集せず、機密情報をLLMに渡す前に自動的にマスク）。

使い方：pip install brytlog でインストール後、brytlog --config を実行するか、brytlog をプレフィックスとしてコマンドを実行すると設定プロセスが開始されます。設定にはLLMプロバイダー（例：Anthropic）、モデル（例：claude-haiku-4-5）、APIキーが必要です。Google Gemini（Google AI Studioからキーを取得）、カスタムOpenAI互換エンドポイント（Ollama、vLLMなど）もサポート。Azure OpenAIは未サポート。

基本的な使用法：任意のコマンドの前に brytlog を付けるだけ。例：brytlog python run.py。複数コマンドを連鎖させる場合は、全体を引用符で囲みます。エージェントワークフローでは、AGENTS.mdに使用説明を追加することで、エージェントが自動的にBrytlogを利用するようになります。

仕組み：Brytlog はコマンドを子プロセスとして実行し、デフォルトでstdoutとstderrを端末からリダイレクトし、AI要約のみを出力します。以下の3つのシナリオを検出：正常終了（成功メッセージのみ）、警告ありの正常終了（サンプリングした要約を生成）、クラッシュ（問題/修正レポートを生成）。CLIフラグと環境変数による高度なカスタマイズが可能（--quietで生ログのリアルタイム表示を抑制、--no-quietで表示）。環境変数でAPIキー、プロバイダー、最大入力トークン数（デフォルト4000）、システムプロンプト、温度などを設定可能。設定ファイルは ~/.brytlog.json にグローバル保存され、ログファイルは brytlog-reports/ と brytlog-raw/ にローカル保存されます。

要約すると、Brytlog は軽量でオープンソース、クロスプラットフォーム、言語非依存のソリューションであり、AI要約技術を通じて開発者とAIエージェントのターミナルログ処理効率を大幅に向上させます。