mathomhaus/guild

エージェントギルド (The Agent Guild) – 概要

概要 – Guild は、組み込みSQLiteデータベースをバックエンドとするローカル MCP (Multi-Client Protocol) サーバー を実行する単一バイナリのGoプログラムです。AIコーディングエージェント（Claude Code, Codex, Cursorなど）のために、共有コンテキスト、メモリ、タスクボードを保存します。エージェントはクエストを取得し、「ナレッジ」エントリを読み書きし、短いメモを残すことで、新しいセッションが前回の終了地点から正確に再開できるようにします。

主な機能

• ハイブリッド検索 – BM25キーワードマッチングとベクトル類似性（組み込みのONNXエンベダーまたはオプションのOllamaエンドポイント経由）を組み合わせた検索。これにより、エージェントは正確な用語検索と意味的なマッチングを同じクエリで行えます。
• アトミックなクエスト取得 – エージェントは作業前にクエストをロックし、複数のエージェントが競合するのを防ぎます。
• 永続的な状態 – すべてのデータ（クエスト、ナレッジ、誓約、概要）は ~/.guild/ 下のローカルSQLiteファイル（またはDockerボリューム）に保存されます。エディタの再起動、コンテナの再起動、さらにはMCP対応エディタ間の切り替えを行っても状態は保持されます。
• エージェントモードCLI – AIエージェントから呼び出された際、コマンドは単一のJSONエンベロープ（--agent フラグ、GUILD_AGENT=1、または自動検出）を出力するため、エージェントは画面スクレイピングなしで結果を解析できます。
• ライフサイクル・フック – guild hooks install を使用してエディタ固有のフックファイル（Claude Code, Codex）を書き込み、セッション開始時にコンテキストを自動的に注入し、圧縮前にキャプチャできます。

典型的なワークフロー

1. インストール – 提供されたスクリプト、Homebrew、またはDockerを使用して、ビルド済みのバイナリ（意味検索を含む）をダウンロードします。
2. プロジェクトの初期化 – guild init でリポジトリを登録し、AGENTS.md ブロックを作成し、検出されたMCPクライアントにプロジェクトを登録します。
3. セッション開始 – エージェントが guild_session_start(project="myapp") を呼び出し、プロジェクトの誓約、最後の概要、および最優先のクエストを受け取ります。
4. 作業 – エージェントがクエストを取得 (guild quest accept …) し、ナレッジを検索 (guild lore appraise …) し、新しい観察結果を記録 (guild lore inscribe …) し、進捗を記録 (guild quest journal …) します。
5. 完了 – エージェントが概要を書き込み、クエストを完了します。依存するクエストが次のエージェントのために利用可能になります。

重要性 – 大規模言語モデルのコーディングアシスタントはコンテキストウィンドウが小さく、セッション終了後に作業内容を忘れてしまいます。Guildは、永続的で検索可能なメモリと調整されたタスクボードを提供することで、複数のエージェント（または同じエージェントのセッション間）が重複作業なしで協力できるようにします。

インストールハイライト

• macOS/Linux: curl …/install.sh | sh（完全な意味検索）または brew install mathomhaus/tap/guild。
• Windows: PowerShellインストーラー（キーワード検索のみ）。
• Dockerイメージにはエンベダーが含まれており、状態は名前付きボリュームに保存されます。

拡張性 – 開発者は新しい「キャンペーン」（タスクのグループ化）を追加し、通常のGitHubフローで貢献できます。リポジトリには CONTRIBUTING.md、AGENTS.md、およびモデル埋め込みに関するドキュメントが含まれています。

---

すべての詳細はリポジトリのREADMEから直接引用しており、追加の主張は行っていません。