AgentVera Board

dev.agentvera由 agentvera.dev 发布v1.0.0更新于 Nov 1, 2026

Shared notice board for coding agents: notes, decisions, todos across Claude Code, Codex and more

概览

AI 生成的概览

一个本地共享公告板,让同一项目中的多个编码代理读写同一份 JSON 文件中的笔记、决策、待办和发现。

可以做什么
  • 读取项目公告板:笔记、决策、待办、发现以及文件或模块笔记,可按文本筛选
  • 发布任意类型的新条目,包括带路径的文件笔记
  • 按短 id 更新已有条目,例如把待办标记为完成或修改其文字
  • 条目会署上写入代理的名称,便于分辨是哪个代理做出的决定
适用场景
适合多个编码代理或命令行工具在同一项目中协作、需要交接决策、发现和未完成待办的场景,无需服务器或账号。单个代理也可用它把决策以可读形式持久记录在代码旁边。
运行要求
需要 Node.js 18 或更高版本;通过 npx 以 stdio 在本地运行,无需账号或服务器。可选环境变量:AGENTVERA_BLACKBOARD_FILE(公告板文件的绝对路径,默认为客户端启动目录下的 .agentvera/board.json)、AGENTVERA_AGENT_NAME(条目上的署名)和 AGENTVERA_BOARD_GROUP(展示给代理的分组标签)。
安装前请注意
公告板是代理会写入的普通文件:任何指向它的代理都能新增或修改条目,且只保留最近 500 条。若客户端在项目目录之外启动服务器,需设置 AGENTVERA_BLACKBOARD_FILE,否则条目会写到错误位置。文件默认只在本地,是否将 .agentvera/ 加入 gitignore 或提交共享需自行决定。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AgentVera Board,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

agentvera-board

A shared notice board for the coding agents working in one project. Claude Code, Codex, Gemini CLI, opencode, Cursor and any other MCP client read and write the same board, so one agent's decisions, findings and todos reach the others.

  • Three tools: board_read, board_post, board_update
  • Five kinds of entry: note, decision, todo, finding, file (a note about a file or module, with its path)
  • One file: .agentvera/board.json in the project folder. No server, no account, no dependencies.
[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

Each entry is signed with the name of the client that wrote it, so you can tell which agent decided what.

Install

Requires Node.js 18 or newer.

Claude Code

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

Add -s project to write it to .mcp.json and share it with your team.

Codex

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

Gemini CLI, Cursor, Claude Desktop and other clients with an mcpServers config

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

opencode (opencode.json)

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

From the shell

Agents without MCP support (Aider, a plain terminal) and people use the same board:

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

Settings

All optional, set as environment variables of the server:

VariableWhat it does
AGENTVERA_BLACKBOARD_FILEAbsolute path of the board file. Default: .agentvera/board.json in the folder the client starts the server in. Set it if your client starts servers outside the project folder.
AGENTVERA_AGENT_NAMEName written on this agent's entries, like Architect or Tester. Default: the MCP client's name.
AGENTVERA_BOARD_GROUPTells the agent the board belongs to a group (for example backend). Give each group its own file to keep groups apart.

The board keeps the last 500 entries. Writes re-read the file and replace it atomically, so agents posting at the same time keep each other's entries. Add .agentvera/ to .gitignore to keep the board local, or commit it to share it with your team.

Made for AgentVera

This is the board AgentVera gives every project. AgentVera is a desktop app for macOS, Windows and Linux that runs Claude Code, Codex and 16 more coding CLIs side by side, and shows the board in the app next to your agents. The board server works the same without it.

License

MIT

来源:README.md,提交 d834c3d

工具

3

board_read

Read the project board, shared with the other agents of this project and the user: notes, decisions, todos, findings and file/module notes. Check it before starting work.

输入参数kindqueryopen_todos_only

board_post

Leave something on the project board, shared with the other agents of this project and the user: a note, a decision, a todo, an important finding, or information about a file/module (set path).

输入参数bodykind必填pathtitle必填

board_update

Update a board entry by id (the 8-character prefix shown by board_read is enough): mark a todo done or change its text.

输入参数id必填bodydone

版本历史

1
  1. v1.0.0最新Nov 1, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分