Pike Agent

pike-agent は、Linux上でのプログラムの動作を記録・分析します。プログラムのアクティビティをトレースし、データベースにインデックス化し、TUIでLLMエージェントとチャットできます。

プロンプトの例:

• クラッシュ診断: このプログラムがバスエラーでクラッシュしました。何が起きたのですか？
• 競合状態の検出: このプログラムが一時ファイルを作成する方法に、競合状態はありますか？
• マルウェアトリアージ: 本番サーバーでこのプロセスが動いているのを見つけました。心配すべきでしょうか？

導入については、Say hi to Pike! を参照してください。

仕組み

pike-agent は strace を使ってプログラムが行うすべてのシステムコールを記録し、全文検索可能なSQLiteデータベースにインデックス化します。LLMエージェントがツール呼び出しを通じてこのデータベースに問い合わせ、プログラムの動作に関する質問に答えます。

• ローカル推論（llama.cpp）と外部API（Claude、Geminiなど）をサポート
• システムコール引数の全文検索
• システムコールのドキュメントを参照するマニュアルページ検索

インストール

uv pip install -e .

Python 3.13+ と、システムにインストールされた strace が必要です。

使用方法

初回実行時、デフォルトの設定ファイルが ~/.config/pike-agent/config.toml に作成されます。これを編集して推論プロバイダーとモデルを設定します。デフォルトではローカルのllama.cppサーバーを指します。

Pike-agent は、ツール呼び出しが得意なモデル（例：Gemini 3 Pro、Qwen 3.5、Claude 4.6 Sonnet...）で最適に動作します。

トレースの記録

コマンドをトレースする:

pike-agent run -- ./my-program --flag

実行中のプロセスにアタッチする:

pike-agent attach 1234

どちらも、インデックス化されたトレースを含む .db ファイルを生成します。

エージェントとのチャット

記録されたトレースでチャットセッションを開始する:

pike-agent chat trace.db

ライセンス

GPLv3.