buddie

Buddieを使う理由

エージェントがタスクを終え、CIが通った、ソースが要約を裏付けている、あるいはノートパソコンにCUDAとPython 3.12がある、と報告します。確信に満ちた口調で、実際に正しいこともよくあります。間違っているとき、その誤りは自信たっぷりの一文に隠れています。

Buddieは、確認できることと、単に主張されていることを切り分けます。対応する主張はエビデンスそのものに照らして確認し、推測ではなくマシンの実際の観測結果をエージェントに提示し、確認できなかった内容は未確認として明示します。公開されたディープリサーチレポートから確認可能な引用929件を調査したところ、212件は引用元のページに記載されていないか、内容が改変されていました。Buddieはそのうち207件を検出しました（調査）。

Buddieの機能

検証。 Buddieは、根拠が示された主張をエビデンスと照合します。たとえば、引用文をリンク先のページと、ファイルやコミットをリポジトリと、マージ済みPRやCIの成功をGitHubと、テスト結果をコマンド実行記録と照らし合わせます。検証には言語モデルが関与しないため、エージェントが別の判定になるよう言いくるめることはできません。

不一致の検出。 Claude CodeとCodexでは、Buddieのフックが回答をあなたに届ける前に確認します。主張が事実と一致しない場合、理由とともに回答をエージェントに差し戻すため、主張を修正するか、何が未検証なのかを明確に伝えられます。ほかのクライアントは、MCPまたはコマンドラインから同じ検証を呼び出し、その結果に応じて処理します。

観測。 コマンドを提案する前に、エージェントはタスクに必要なマシン情報をBuddieに問い合わせられます。対象はオペレーティングシステム、CPU、メモリ、GPU、Python、ランタイム、ツールです。Buddieは許可されたカテゴリだけを読み取り、何も変更せず、各値をどのように観測したかを記録します。

動作を見る

エージェントの主張を検証する

エージェントが、日付パーサーを修正し、テストスイートがすべて成功したと報告しています。この主張には、Buddie が確認できる小さな アンカー ⚓ run:pytest -q => 41 passed が付いています。セッションのトランスクリプトには、テストコマンドが実際に出力した内容が記録されています。

クローンから自分で実行できます。レポートとトランスクリプトは examples/work にあります：

cd buddie/examples/work
buddie verify report.md --transcript session.jsonl --no-github

BLOCK anchor line 3 ⚓ run:pytest -q => 41 passed: output has no '41 passed'; it ends: ….......................................... 1 failed, 40 passed in 3.1s
note  pr:/ci:/run: anchors show what happened (PR state, checks on a commit, a command and its output), not that the code is correct
buddie FAIL: effects 0/1 hold, 1 broken

これらのファイルは学習用のフィクスチャです。Buddie は pytest を再実行せず、記録された出力を読み取ります。--json receipt.json を指定すると、判定の根拠となった証拠を記載したレシートも書き出されます。引用、PR、CI の例と、各インテグレーションが確認する内容については、検証ガイドをご覧ください。

環境を把握する

エージェントがローカル開発環境のセットアップを依頼されました。OS、GPU、Python のバージョンを推測する代わりに、本人が許可した3つのカテゴリについて Buddie に問い合わせます。

buddie snapshot --category system.os --category hardware.gpu --category software.python \
  --task "configure local development environment" --json diagnostics.json

buddie snapshot: diagnostics of 3 categories (grants active, policy absent; these govern the categories only)
  system.os: collected
    name: Windows 11  [os_interface]
  hardware.gpu: collected
    adapters: [model NVIDIA GeForce GTX 1650, source nvidia_smi_gpus, vendor NVIDIA, vram_bytes 4294967296]  [fixed_program]
  software.python: collected
    buddie_runtime: implementation cpython, pip True, venv True, version 3.14.6  [buddie]

buddie 2.0.0 の実行結果を抜粋しています。表示されている行は編集されておらず、このマシンで観察されたほかの値は省略しています。diagnostics.json には、各値の取得方法と取得時刻を含む完全なドキュメントが保存されます。

許可していないカテゴリは拒否として報告され、そのコレクターは実行されません。Buddie が読み取れない値は、その理由とともに利用不可として示されます。Diagnostics は読み取り専用で、何もインストールしません。エージェントにより正確な情報を提供しますが、その後に実行するコマンドが正しいことを保証するものではありません。カテゴリ、許可、ドキュメント。

はじめに

Buddie には Python 3.11 以降が必要で、依存関係はありません。

Claude Code

おすすめの開始方法です。このプラグインにより、回答の確認、環境診断を含む MCP ツール、およびセッションのトランスクリプトに対する run: チェックが追加されます。

/plugin marketplace add tsyyan/buddie
/plugin install buddie@buddie

このリポジトリのデフォルトブランチをインストールします。診断を許可するには、選択したカテゴリを ~/.config/buddie/ の environment.toml に保存してください（Windows では %APPDATA%\buddie\）。上記のデモの場合：

version = 1
allow = ["system.os", "hardware.gpu", "software.python"]
roots = []

レベル、導入モード、フックが読み取る内容については、Claude Code ガイドをご覧ください。

その他の連携

• Codex： codex plugin marketplace add tsyyan/buddie を実行し、続いて codex plugin add buddie@buddie を実行して、/hooks でフックを有効にします。チェックは Stop 時に実行されます。run: の申告は未チェックのままです。Codex ガイド
• 任意の MCP クライアント： uvx buddie serve で stdio サーバーを起動します。ゲートはありません。エージェントがツールを呼び出します。 連携
• コマンドラインと CI： pip install buddie を実行し、続いて buddie verify REPORT.md --json receipt.json を実行します。FAIL の場合は終了コード 1 を返します。GAPS と EMPTY の場合は終了コード 0 を返すため、PASS を必須とする CI ステップでは、レシートの結果を確認してください。
• Claude Desktop： ゲートなしで、Releases の .mcpb バンドルを使用します。 デスクトップガイド

すべての利用環境の詳細：始め方。

リリース状況

	バージョン
ここで説明しているリリース：PyPI、GitHub Releases、デスクトップバンドル、MCP Registry	2.0.2

2.0.1 からアップグレードする場合、必要な作業はありません。2.0.2 では、ローカルフィードバックツール（feedback_start、feedback_resolve、feedback_accept）、GitHub の引用チェック、バージョン管理された公開リリースノートが追加されます。2.0.0 からのアップグレードでも、必要な作業はありません。2.0.1 では、コードページが UTF-8 ではない Windows システムで MCP サーバーが入力を読み取る方法が修正されました。1.1.1 からアップグレードする場合、1.x のセットアップで必要な作業はありません。異なる可能性がある点とその理由については、変更履歴をご覧ください。

ドキュメント

トピック	参照先
すべての利用環境へのインストール	始め方
各連携の機能	連携
チェック、結果、レシート	検証、レシート
環境診断	環境
セキュリティとプライバシー	制限事項、セキュリティ、プライバシー
コントリビューション	CONTRIBUTING.md
その他すべて	ドキュメント索引

制限事項

Buddieは真偽を判定するツールではありません。リンク付きの引用や、ファイル、PR、CI、コマンドに関する根拠を明示した主張など、認識できる形式の主張を、読み取れる根拠と照合します。言い換えや根拠が明示されていない主張はチェックされません。PASSはチェックした内容のみを対象とし、GAPSとEMPTYは合格を意味しません。

回答チェックはClaude CodeとCodexでのみ利用でき、回答をロックするのではなく返します。エージェントは主張を修正するか、未検証であることを明示します。あなたのユーザーとして実行されているエージェントは、ローカルの根拠、設定、診断許可ファイルを編集できます。エージェントが引き上げられない制限を設定できるのは、管理者が保護するポリシーのみです。

Buddieはローカルで動作し、モデル呼び出しもテレメトリーもありません。レポートで引用されているページを取得し、PRとCIに関する主張についてGitHubを呼び出します。すべての制限事項 · セキュリティ境界 · プライバシー

---