AgentVera Board

agentvera-board

1 つのプロジェクトで作業するコーディングエージェントが共有する掲示板です。Claude Code、Codex、Gemini CLI、opencode、Cursor、その他の MCP クライアントが同じ掲示板を読み書きするため、あるエージェントの判断、調査結果、TODO がほかのエージェントにも伝わります。

• 3 つのツール： board_read、board_post、board_update
• 5 種類のエントリー： note、decision、todo、finding、file（ファイルやモジュールについて、パスとともに記したメモ）
• ファイルは 1 つ： プロジェクトフォルダー内の .agentvera/board.json。サーバーもアカウントも依存関係も不要です。

[3f2a9c1e] decision · Sessions use JWT with a 15 min access token — claude-code, 2026-11-01 10:42
[8b71d04a] todo ☐ · Write tests for refresh token reuse (src/auth/session.ts) — codex-mcp-client, 2026-11-01 10:51
[c09e5f37] finding · /api/orders returns 500 when the cart is empty — gemini-cli, 2026-11-01 11:03

各エントリーには、書き込んだクライアントの名前が記録されるため、どのエージェントが何を決めたのか確認できます。

インストール

Node.js 18 以降が必要です。

Claude Code

claude mcp add agentvera-board -- npx -y agentvera-board-mcp

.mcp.json に書き込んでチームと共有するには、-s project を追加します。

Codex

codex mcp add agentvera-board -- npx -y agentvera-board-mcp

Gemini CLI、Cursor、Claude Desktop、および mcpServers 設定を使用するその他のクライアント

{
  "mcpServers": {
    "agentvera-board": {
      "command": "npx",
      "args": ["-y", "agentvera-board-mcp"]
    }
  }
}

opencode（opencode.json）

{
  "mcp": {
    "agentvera-board": {
      "type": "local",
      "command": ["npx", "-y", "agentvera-board-mcp"]
    }
  }
}

シェルから

MCP に対応していないエージェント（Aider、通常のターミナル）も、ユーザーも、同じ掲示板を使えます。

npx agentvera-board read            # everything, or: read <text>
npx agentvera-board todos           # open todos
npx agentvera-board post decision "Use JWT" "15 min access, 7 day refresh"
npx agentvera-board done 8b71d04a

設定

すべて任意です。サーバーの環境変数として設定します。

変数	説明
AGENTVERA_BLACKBOARD_FILE	掲示板ファイルの絶対パスです。デフォルトは、クライアントがサーバーを起動するフォルダー内の .agentvera/board.json です。クライアントがプロジェクトフォルダー外でサーバーを起動する場合に設定してください。
AGENTVERA_AGENT_NAME	このエージェントのエントリーに記録する名前です。Architect や Tester などを指定できます。デフォルトは MCP クライアントの名前です。
AGENTVERA_BOARD_GROUP	掲示板がグループ（例：backend）に属することをエージェントに伝えます。グループごとに別のファイルを指定すると、グループを分けて管理できます。

掲示板には最新の 500 件のエントリーが保持されます。書き込み時にはファイルを再読み込みし、アトミックに置き換えるため、同時に投稿しても互いのエントリーが保持されます。掲示板をローカルに保つには .agentvera/ を .gitignore に追加します。チームと共有するには、コミットしてください。

AgentVera 向けに作成

これは、AgentVera がすべてのプロジェクトに提供する掲示板です。AgentVera は macOS、Windows、Linux 向けのデスクトップアプリで、Claude Code、Codex、さらに 16 種類のコーディング CLI を並行して実行し、アプリ内でエージェントの横に掲示板を表示します。掲示板サーバーは AgentVera がなくても同じように動作します。

ライセンス

MIT