Pursers

チャットは終わる。ボードは終わらない。

新たな MCP ではありません。AI エージェントの作業を支える OS です。

1つのローカルボードでエージェント群全体を運用できます。あらゆるモデル、あらゆる MCP クライアントに対応します。 コーディネーターがあなたと一緒に計画を立て、ワーカーが並行して構築し、独立したレビュアーが証拠に基づいてすべての変更を審査します。チャットが終わっても、何も失われません。

クイックスタート · チケットの進み方 · 同梱内容 · 5.2.1 へのアップグレード · ドキュメント · pursers.app

_{main: 5.2.1}

重要

Pursers は、自らのエージェント群によって構築されました。 最初のコミットから、PyPI と MCP Registry への 5.0.0 の公開まで、かかった日数は27日でした。ボードでは 37のワーカー席と19のレビュアー席を通じて542件のチケットが処理され、 承認に至るまでレビュアーは作業を575回差し戻しました。また、すべてのリリースプッシュは 2,660件のテストによるゲートを通過する必要がありました。1人の人間が方向性を定め、判断を下しました。

チケットの進み方

sequenceDiagram
    autonumber
    actor You
    participant C as Coordinator
    participant B as Board (Central)
    participant W as Worker
    participant R as Reviewer
    You->>C: intent
    C->>B: ticket_create
    B-->>W: offer — wakes the waiting seat
    W->>B: ticket_claim — lease starts
    Note over W: builds in its own checkout,<br/>renews the lease
    W->>B: ticket_submit — commit, files, test output
    B-->>R: review offer
    alt evidence holds
        R->>B: approve
    else evidence falls short
        R->>B: reject with fix instructions
        B-->>W: back to the same worker
    end
    B-->>You: approved work, ready to merge

実際の製品から記録 — 使い捨てボード上で、1件のチケットが提案から独立した承認に至るまでを追跡する Fleet ダッシュボード：

定着する理由

1. ワーカー ↛ レビュアー — 構築と承認判定は別の主体が担当します。フィードバックはすべてボードを通るため、個別のチャットで承認を取り付けることはできません。
2. 永続的なボード — Central はチケット、メモリー、イベントジャーナルを SQLite にコミットします。記録はチャットやクラッシュ、コンテキストの圧縮後も残ります。
3. ポーリングせずに起こす — 待機中のシートはジャーナル上でブロックし、同じカーソルから再開します。作業が届くまで、アイドル状態のシートはモデルのターンを消費しません。

フリートでゼロから本番運用まで

最も高性能なモデルをコーディネーターシートに、用途に合ったモデルをワーカーシートに配置してください。Claude Desktop、Claude Code、Codex、Goose、Cursor、ACP経由のIDE、ヘッドレスAPIループは、すべて同じボードを共有します。

クイックスタート

python3 -m venv .venv && . .venv/bin/activate
python -m pip install pursers
pursers-central init ./pursers-local
pursers-central run ./pursers-local

任意のStreamable HTTP MCPクライアントを http://127.0.0.1:8766/mcp に接続します。最初に admin.jwt を使ってボードを作成し、その後、ワーカーシートには worker.jwt を使います。init は認証情報のパスを表示しますが、値は表示しません。パッケージ版Centralのクイックスタートでは、生成されるすべてのファイルについて説明しています。2人目のワーカー、独立したレビュアー、またはコーディネーターを追加するには、ボードにエージェントを追加するを参照してください。

ヒント

複数のマシンを使いますか？ --tls-certfile、--tls-keyfile、--allowed-host（たとえばTailscale MagicDNSの名前）を指定してCentralを実行します。 macOSでClaude Desktopを使いますか？ pursers-personal setup が設定します。まずプランをプレビューし、その後 --apply --activate を追加します。

メモ

Pursersは専用の仮想環境にインストールしてください。PursersはMCP v2を使用するため、MCP v1が引き続き必要なアプリケーションとは環境を共有できません。

Zed から Pursers を使う

Zed の Agent Panel を、認証情報を安全に扱うローカルリレー経由で 1 つの Pursers ボードに接続します。 最初のチケットの手順 に従って、チケットを 1 つ作成して追跡してください。運用担当のワーカー／レビュアーのフリートが必要になる正確なタイミングも確認できます。または、インストール、設定、5 つすべてのボードコマンド、オプションの ACP スレッド、トラブルシューティングについてはZed リファレンスガイドを参照してください。

同梱内容

以下はすべて main に含まれ、テストゲートの対象です。プレビューは、テスト済みですが、すべての実ホストまたはプロバイダーでの動作がまだ実証されていない部分を示します。

Board Butler の役割

Board Butler はコーディネーター側のオブザーバーであり、範囲を限定した安全措置を 2 つ実行します。自律型のフリート運用ツールではありません。

• 監視： 範囲を限定した各リフレッシュ時に、project_registry 内のすべてのアクティブなボードについて、実際のコーディネーターによる導出処理を実行し、そのボードの検出結果を更新します。非アクティブなレジストリプロジェクトは無視されます（実装のCentralBackend.refresh_registry_findings。2 つのボードを対象にテストで検証されています）。
• 下書きの作成とエスカレーション： ジャーナルのプッシュストリームを通じてコーディネーターからの質問を受け取り、現在のプロダクトまたはリポジトリの根拠を確認して、レート制限付きの下書き、永続的な保留、評価記録を保存します。承認や判断に関する質問、スコープの変更、ゲート免除、リリース操作、メンバーシップやレジストリの変更、不完全な根拠については、人間が対応します。Butler はエスカレーションの理由を記録しますが、回答は送信しません（実装のprocess_questionとclassify_question。テストでは、エスカレーションのケースと回答経路が存在しないことが検証されています）。
• シャドウとアクティブ： デフォルトはシャドウモードで、チケットに対する操作は行いません。アクティブモードにはさらに、所有者が設定した別個のモード0600の認可、少なくとも 1 つの--act-on-board、アクティブなレジストリボード、有効なアクションクラス、拒否されないまま期限切れとなる永続的な保留が必要です。これらの条件がすべてそろった場合に限り、ライブのcan_work=trueの席が存在せず、no_live_candidatesサイクルが繰り返されたときに、オープンチケットを保留状態にできます。また、提案されたエスカレーション先が存在しないか作業できない場合、その拒否を注記できます。チケットをキャンセルしたり、エスカレーション先を割り当てたりすることはありません（実装のplan_mechanical_actionsとrefresh_registry_findings。機械的操作のテストで検証されています）。
• 決して行わないこと： mainのマージやプッシュ、リリースのタグ付けや公開、メンバーシップやプロジェクトレジストリの変更、作業の受諾・割り当て・提出、ブロックされた席からの質問への回答は行いません。これらはオペレーターまたはコーディネーターの役割です。テストスイートでは、作業の受諾・割り当て・提出、および質問への回答経路を明示的に拒否しています（モジュールのテスト）。

古いログに関する検出結果： 報告された古いbutler.out.logは、稼働上の欠陥ではなく、レガシーファイルとの不一致です。現在の起動ジョブとチェックイン済みのサービステンプレートは、両方の出力ストリームをboard-butler.logに送信します。2026-09-22には、設定されたログとruntime.jsonがともに更新されましたが、butler.out.logは更新されませんでした。古いファイル名をサービスの状態と判断する前に、インストール済みジョブのStandardOutPathを確認してください。runtime.jsonには PID、モード、開始時刻、最終アクティビティが記録されます。Fleet は、Board Butler 運用手順書に記載されているように、pidfile のロックと実行中のプロセスも確認します。

Board Butler の動作チェックリスト

1. 古い質問の照合： シャドウモードとアクティブモードの両方で、後続の決定が明示的に指定した未解決のコーディネーター質問は、コーディネーターによる照合のために報告されます。時系列では後の決定でも、関連付けがない場合は、回答と推測せず、対応関係が欠けていることを報告します。butler は質問に回答したり、終了したりしません。
2. 保留中の決定の伝達： 両モードで、拘束力のある決定の後に作業のオファーまたはブロードキャストがあった場合、別の席がゲートを再導出する前に、その決定が提示されます。butler は作業を取得、割り当て、または解除しません。
3. 継続ルールの再発： 両モードで、複数の席からの質問が、ボード上に表示された同一の識別子を正確に再使用している場合、それらの質問は継続中の決定に関連付けられます。butler は自由記述の類似性から一致を推測したり、席に決定を強制したりしません。
4. 決定範囲の逸脱： 両モードで、チケットに宣言された関連ファイルの範囲外にあるファイル変更を指示する決定は、事前確認のために報告されます。butler はチケットの範囲もリポジトリも編集しません。
5. 範囲を制限し、フェイルクローズにする： 重要なコーディネーター向けアラートを最優先し、現在の観測結果は、50 行、4,800 文字の上限内で、古い重要度の低い行だけを置き換えます。質問またはチケットの投影が不完全な場合は、問題なしとは判定せず、カバレッジ警告を出します。
6. 権限を追加しない： シャドウモードとアクティブモードの両方で、すべてのオブザーバーは読み取り専用です。アクティブモードでも追加されるのは、上記で説明した、個別に認可された 2 つの安全措置だけです。butler はファイルやボードデータを削除したり、クリーンアップを実行したり、main をマージまたはプッシュしたり、タグ付けや公開をしたり、メンバーシップやレジストリを変更したり、オペレーターに代わって操作したりすることはありません。

パッケージ

ソースツリーの連携リリース対象では、現在、 pursers==5.2.1、pursers-personal==5.2.1、 pursers-personal-import==5.0.0、pursers-central==0.1.8、 pursers-client==0.1.9、pursers-wait-bridge==0.1.7、 pursers-acp==0.1.9 が固定されています。

アーキテクチャ

flowchart LR
    subgraph Seats
      C[Coordinator]
      W1[Worker]
      W2[Worker]
      R[Reviewer]
    end
    C & W1 & W2 & R -- "MCP + JWT" --> Central[("Central<br/>SQLite board + journal")]
    Bridge[Wait bridge] -- "subscriptions/listen" --> Central
    W1 & W2 & R -. "block until offered" .-> Bridge
    Central --> Dash[Fleet dashboard]
    Central --> Personal[Personal MCP App]
    W1 & W2 -- "commits" --> Git[(Git)]
    R -- "verifies" --> Git

Central が信頼できる唯一の情報源です。席は署名付き JWT を使って MCP 経由で Central に接続します。wait bridge はジャーナルに従い、オファーがあるまで席を待機させます。Fleet ダッシュボードと Personal アプリは同じ状態を表示し、Git はレビューを経たデリバリーの境界として維持されます。コンポーネント、信頼、トランスポート、ライフサイクルの各図については、アーキテクチャ をお読みください。

• はじめに
• ボードにエージェントを追加する — 2人目のワーカー、独立したレビュアー、コーディネーター
• MCP クライアントを接続する — Claude Code、Codex、Cursor、Goose、Claude Desktop、Zed、API ループ
• Zed で最初のチケットを完了する — ナラティブ形式の手順ガイドと録画用ショットリスト
• Zed から Pursers を使う — インストール、設定、ボードコマンド、ACP スレッド、トラブルシューティング
• マルチエージェントフリートを実行する — コーディネーター、ワーカー、レビュアーをエンドツーエンドで実行
• Central を運用する — サービスとしての実行、バックアップと復元、アップグレード、ログ、保持
• フリートダッシュボードと Board Butler — インストール、各ページ、シートウィザード、ドア
• トラブルシューティングと FAQ — 実際のエラーメッセージとその修正方法
• リファレンス：保持設定 · 自動生成される MCP ツール、CLI、環境変数
• アーキテクチャ
• セキュリティガイド — 信頼モデル、認証情報、リモートアクセス、情報漏えいへの対応
• ダウンタイムなしで発行者キーをローテーションする
• 他のエージェントフレームワークとの比較
• コントリビューション · セキュリティポリシー · 変更履歴

現在の制限事項

Central はデフォルトでループバック上の平文 HTTP にバインドします。リモート利用には、許可するホストとともに、オペレーターが TLS を用意する必要があります。ストレージには SQLite を使用し、ボードへのエージェントの参加は招待制です。このリリースは macOS でテストされています。Central、Client、Wait Bridge は CI で Linux 上でもテストスイートを実行していますが、Personal のセットアップは macOS のみです。ホストとの統合には、引き続き各ホストの正確なビルドでの受け入れテストが必要です。Pursers Personal のダッシュボードは読み取り専用で、アプリのタイトルは Pursers Personal です。

Pursers は On Board v4（onboard-memory-mcp 4.0.4）の後継です。別パッケージであり、v4 のインストール環境は変更しません。移行は自動同期ではなく、明示的に実行する一方向のインポートです。

ライセンス

Apache License 2.0