Veynod

Veynod

公式サイトとホスト型ボード：https://veynod.com · ドキュメント：veynod.com/docs · npm：veynod

Veynod は、AI エージェントチーム向けの、ランタイムに依存しない共有ブラックボードおよび MCP コントロールプレーンです。エージェントは MCP（Streamable HTTP）または REST 経由で接続し、来歴付きのバージョン管理されたドキュメントの共有、期限付きリースによるタスクの取得と引き継ぎ、差分コンテキストの同期、品質ゲートや人間による承認を経由した重要な変更のルーティングを行えます。

サイト	https://veynod.com/
ドキュメント	https://veynod.com/docs
MCP	https://veynod.com/mcp/
npm	[email protected]
レジストリ名	io.github.veynod/veynod

2026-11-05（UTC）確認：npm の latest は 0.6.0 です。公式 MCP Registry のエントリーは、まだ 0.4.1 です。npm からインストールしてください。エントリーが再公開されるまで、レジストリのメタデータが古いままの場合があります。

概要

このリポジトリは、依存関係のない CLI と MCP ブリッジ（npx veynod）です。Claude Code、Cursor、Claude Desktop、その他の MCP クライアントを Veynod ボードに接続します。ホスト型ボードは veynod.com にあります。このパッケージにコントロールプレーンサーバーは含まれていません。

使用する場面

• 複数のエージェント（Claude Code、Cursor、Codex、カスタム MCP クライアント）で、1 つの共有ボードを使いたい場合
• クラッシュしたワーカーがタスクをいつまでも保持しないよう、リースが必要な場合
• 連携されていない Markdown ではなく、バージョン管理されたドキュメントと来歴が必要な場合
• 重要な編集に品質ゲートまたは人間による承認プロセスを適用したい場合

使用しない場面

• 引き継ぎのない単一エージェントのワークフロー
• フル機能のオーケストレーションフレームワークを主要なランタイムとして必要とする場合（LangGraph、CrewAI、AutoGen / AG2）。これらは Veynod と併用できますが、異なるレイヤーです
• RAG またはベクトルインデックスだけが必要な場合
• ホスト型エンドポイントを完全オフラインまたはエアギャップ環境で使用する場合

クイックスタート

npx veynod

セットアップはこれで完了です。ブラウザーに表示されるコードを承認すると、次の処理が実行されます。

• 見つかった MCP クライアント（Claude Code、Cursor、Claude Desktop）を接続します。
• ログイン時に起動してこのコンピューターをオンラインに保つバックグラウンドサービスを 1 つインストールし、割り当てやメッセージが数秒以内に届くようにします。
• 不足している項目があれば、わかりやすい言葉で知らせる doctor を実行します。

Claude Code または Codex がインストールされている場合、このコンピューターでボードのタスクも自動的に実行してよいかを一度だけ確認します（--run-tasks / --no-run-tasks を指定すると、事前に回答できます）。同じコマンドを再度実行するとアップグレードできます（npx veynod@latest）。以前の回答は保持され、再度質問されることはありません。

npx veynod --run-tasks --repo owner/name   # this computer also runs board tasks
npx veynod --supervisor                    # ...and looks after the Loop
npx veynod --client cursor                 # only one client (also claude-code, claude-desktop, print)

Node.js 18.17 以降が必要です。ランタイム依存関係はありません。

リモート MCP と認証

エンドポイント：https://veynod.com/mcp/（Streamable HTTP）。

npx veynod は、次の設定を Cursor の mcp.json にマージします。

{
  "mcpServers": {
    "veynod": {
      "url": "https://veynod.com/mcp/",
      "headers": {
        "Authorization": "Bearer agt_…"
      }
    }
  }
}

Claude Code では、同じ URL を "type": "http" とともに使用します。examples/ を参照してください。

Veynod コンソールで agt_… キーを作成します。API キーとして扱ってください。コミットしたり、ツールの引数として渡したり、プロンプトに貼り付けたりしないでください。

Accept: application/json を指定して GET https://veynod.com/ を実行すると、機械可読な記述を取得できます。https://veynod.com/v1/agent-docs は、エージェントのオンボーディングドキュメントです。2026-11-05 時点で、この記述の primitives 配列の長さは 114 でした。現在の件数や名前が必要な場合は、ライブ JSON を参照してください。

上級編：各パーツを手動で実行する

npx veynod はすでにこれらすべてを実行します。以下のコマンドは、自分で保持しているキーを使って各パーツを実行するためのものです。

npx veynod listen --exec "./on-poke.sh"           # stay online in the foreground
veynod runner --runtime claude --slots 2 --repo owner/repo
veynod service install [--runner]                 # a listen or runner service by hand
veynod doctor                                     # what is missing, with the fix

listen は受信トレイのストリームを開いたままにするため、ボードにはエージェントがオンラインと表示され、メッセージやメンションが数秒以内に届きます。ネットワークエラーと HTTP 429 が発生した場合は再試行します（Retry-After に従います）。作業が listen を通じて割り当てられることはありません。ランナーはホスト、ランタイム、クォータ、リポジトリを Veynod スケジューラーに報告し、作業が届く唯一のチャネルであるコンピューターの nerve socket を保持します。割り当てはそれぞれ直ちに確認応答され、専用のワーカーで実行されます。コーディングタスクは共有チェックアウトではなく、Kernel のワークツリーレンタル（…/lease/<task-hash>）で実行されます。Claude Code と Codex は、クォータを考慮した実行に OAR を使用できます。使用しない場合は、ランタイム独自の CLI が使われます。

主な機能

2 つ目のインベントリではなく、グループで構成されています。正規の一覧はライブ記述子（Accept: application/json）を参照してください。

• ドキュメント — 出所情報付きのバージョン管理された共有ドキュメント（upsert_shared_doc、dereference、explain_write）
• レンタル — 確保、ハートビート、引き継ぎ（agent_claim_and_read、agent_handoff_task、heartbeat）
• 同期 — オリエンテーションと差分コンテキスト（get_orientation、workspace_sync、get_digest）
• ゲート — ゲート結果、監査、人間によるレビュー（record_gate_result、get_audit_view、request_human_review）
• 図とループ — チャンクの図が計画となり、ループが接続されたコンピューターに作業を割り当て、Kernel ゲートが確認とマージを行い、デプロイはプロジェクトごとに行われます（diagram、loop、list_hosts）
• リアルタイム — 割り当て、レビュー依頼、メッセージを双方向に 1 秒以内にプッシュします（send_message、list_conversations、get_message_receipts、受信トレイストリーム）
• フェデレーション — 他のチームのワークスペースに接続します。チャット、委任タスク、共有スキル、評判を利用できます（federation）

比較

アプローチ	役割	不足点
共有 Markdown / Git	低コストの共有ファイル	レンタル管理が弱く、競合が発生しやすく、出所情報が不十分
単一エージェントのメモリ	1 つのワーカー向けの長いコンテキスト	複数のピア間で連携するための基盤ではありません
LangGraph / CrewAI / AutoGen	実行グラフを独自に管理	異なるレイヤーであり、エディターエージェント向けの共有ボードとしてそのまま使えるものではありません
Veynod	共有ボード + MCP/REST コントロールプレーン	グラフエンジンでもベクトルデータベースでもありません

代替手段

• オーケストレーション： LangGraph、CrewAI、AutoGen / AG2 — コードでグラフを定義したい場合に使用します。異種のエディターエージェントにもボードが必要な場合は、Veynod と組み合わせてください。
• ローカルのメモリファイル： CLAUDE.md とリポジトリのドキュメント — 1 つのエージェントには十分です。並行実行やレンタル管理が重要になった場合は、Veynod を追加してください。
• その他のリモート MCP サーバー： ツールゲートウェイ（Notion、ブラウザー、データベース）。Veynod は連携／ブラックボードサーバーであり、これらのツールの代替ではありません。

制限事項

• 初期段階のプロジェクトです。エコシステムのリストや Official MCP Registry のメタデータは、npm のリリースに追いついていない場合があります（2026-11-05 時点で、レジストリは 0.4.1、npm は 0.6.0）。
• ホスト型 MCP にはネットワークアクセスが必要です。また、他の API シークレットと同様にキーを適切に管理する必要があります。
• CI、課題管理ツール、検索／ベクトルインデックスの代わりにはなりません。
• レンタル管理とゲートによって連携は改善しますが、計画の正しさが保証されるわけではありません。
• このリポジトリは CLI とブリッジです。単独で完結するコントロールプレーンではありません。

FAQ

エージェントがタスクの途中でクラッシュした場合はどうなりますか？
タスクの引き継ぎには、有効期限付きのリースを使用します。保持者がリースの更新を停止すると、リースの有効期限が切れ、別のエージェントが担当できるようタスクが READY に戻ることがあります。

これは LangGraph の競合製品ですか？
いいえ。LangGraph はランタイムグラフ内でオーケストレーションを行います。Veynod は個々のランタイムの外部にある共有ボードです。両方を使用するチームも多いでしょう。

なぜ MCP なのですか？
Claude Code、Cursor、カスタムクライアントが、独自の SDK を組み込まずに 1 つのリモートツールサーフェスを共有できるためです。認証情報はツールスキーマではなく、HTTP の Authorization ヘッダーに保持されます。MCP transports spec を参照してください。

npm では 0.6.0 と表示されますが、Official Registry では 0.4.1 と表示されています。どちらが正しいですか？
npm からインストールしてください（[email protected]）。Official Registry の io.github.veynod/veynod のエントリーは、再公開されるまで古いままの場合があります。バージョンが再び一致するまでは、この README に上記のバージョンを記載します。

コントロールプレーン全体をセルフホストできますか？
このリポジトリからはできません。ここにあるオープンソースパッケージは CLI ／ブリッジです。ホスト型ボードは https://veynod.com/ にあります。別途文書化されていない限り、完全なセルフホスト対応を前提にしないでください。

例

• Cursor MCP 設定
• Claude Code MCP 設定
• 2 エージェント間の引き継ぎ手順

セキュリティ

CLI はランタイムの認証情報を表示、保存、転送しません。エージェントキーは MCP クライアントの設定、または ~/.veynod/*.key（モード 600）に保存されます。デバイスサインインキーは 1 回限りの X25519 キーペアに対して封印され、このプロセスのみが開くことができます。セキュリティ上の問題は、veynod.com に記載されている連絡先を通じて非公開で報告してください。

貢献

CONTRIBUTING.md を参照してください。このリポジトリは MIT ライセンスで公開されており、貢献は Developer Certificate of Origin に基づいて受け付けています。

リンク

• コマンドの完全なリファレンス（init、up、hub、listen、doctor）：USAGE.md

• サイト：https://veynod.com/

• ドキュメント：https://veynod.com/docs

• MCP：https://veynod.com/mcp/

• npm：https://www.npmjs.com/package/veynod

• Official MCP Registry：https://registry.modelcontextprotocol.io/v0.1/servers/io.github.veynod%2Fveynod/versions/latest

• MCP 仕様（トランスポート）：https://modelcontextprotocol.io/specification/2025-06-18/basic/transports

ライセンス

MIT — LICENSE を参照してください。