AgentVera Board

Name: AgentVera Board
Author: agentvera.dev

本地服务

agentvera.devAI 与智能体02 周前更新

代码仓库访问官网

关于 AgentVera Board

AgentVera Board 是供编码 Agent 和人员共同使用的项目公告板。它将笔记、决策、待办、发现和文件引用存于一个本地 JSON 文件，并标明每条内容的发布客户端。

主要功能

01读取、发布和更新公告板条目
02支持待办和发现等五种条目
03将公告板存于项目 JSON 文件
04标注条目的发布客户端
05通过 MCP 客户端或命令行使用

适用场景

01在编码 Agent 之间共享决策
02跟踪项目待办和发现
03从终端读取或更新公告板

MCP 相关

MCP 服务提供读取、发布和更新共享公告板的工具。同一项目中的 MCP 客户端使用同一个本地公告板文件。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "dev-agentvera-board": {
      "command": "npx",
      "args": [
        "-y",
        "agentvera-board-mcp"
      ],
      "env": {
        "AGENTVERA_BLACKBOARD_FILE": "<AGENTVERA_BLACKBOARD_FILE>",
        "AGENTVERA_AGENT_NAME": "<AGENTVERA_AGENT_NAME>",
        "AGENTVERA_BOARD_GROUP": "<AGENTVERA_BOARD_GROUP>"
      }
    }
  }
}

启动命令npx -y agentvera-board-mcp

需要配置的环境变量

AGENTVERA_BLACKBOARD_FILEAbsolute path of the board file (default: .agentvera/board.json in the project folder)

AGENTVERA_AGENT_NAMEName written on this agent's entries (default: the MCP client's name)

AGENTVERA_BOARD_GROUPGroup the board belongs to, shown to the agent

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmagentvera-board-mcp1.0.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
kind	enum	否	note \| decision \| todo \| finding \| file
query	string	否	仅包含含有此文本的条目
open_todos_only	boolean	否

详细介绍

agentvera-board

供同一项目中的编码 Agent 使用的共享公告板。Claude Code、Codex、Gemini CLI、opencode、Cursor 及任何其他 MCP 客户端都可以读取和写入同一个公告板，让一个 Agent 的决策、发现和待办事项传达给其他 Agent。

三种工具： board_read、board_post、board_update
五种条目类型： note、decision、todo、finding、file（关于文件或模块的备注，附带其路径）
一个文件： 项目文件夹中的 .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

每条内容都会标注写入它的客户端名称，因此你可以分辨每个 Agent 做出了什么决定。

安装

需要 Node.js 18 或更高版本。

Claude Code

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

添加 -s project，即可将其写入 .mcp.json 并与团队共享。

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 的 Agent（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`	写入此 Agent 条目时使用的名称，例如 `Architect` 或 `Tester`。默认值：MCP 客户端的名称。
`AGENTVERA_BOARD_GROUP`	告知 Agent 此公告板属于某个分组（例如 `backend`）。为每个分组指定单独的文件，以便彼此区分。

公告板保留最近的 500 条内容。写入时会重新读取文件并以原子方式替换，因此 Agent 同时发布内容时，不会覆盖彼此的条目。将 .agentvera/ 添加到 .gitignore，即可让公告板仅保留在本地；也可以提交该文件，与团队共享。

专为 AgentVera 打造

这是 AgentVera 为每个项目提供的公告板。AgentVera 是一款适用于 macOS、Windows 和 Linux 的桌面应用，可并排运行 Claude Code、Codex 及另外 16 个编码命令行工具，并在应用中、Agent 旁边显示公告板。不使用 AgentVera 时，公告板服务也能正常运行。