PlanWright

tools.planwright由 planwright.tools 发布官方发布者v1.0.2更新于 Oct 24, 2026

Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.

已验证Streamable HTTP可网页运行效率与工作流开发者工具

概览

AI 生成的概览

Planwright 是一个托管式规划看板：人类设定目标，编码代理通过 MCP 认领、拆解、执行并回报工作，全程留有签名审计记录。

可以做什么
  • 会话设置：选择当前仓库或项目，列出工作区与项目，读取、上传或列出 CLAUDE.md、规格与架构文档等上下文文件。
  • 管理计划（initiative）：列出、创建、更新和删除工作区里程碑。
  • 管理目标：按泳道列出目标，查看含运行历史的详情，创建带验收标准的目标，更新并排期。
  • 代理工作流：认领目标、提交拆解计划、检查对齐、记录差异与测试结果、申请验收、追加备注并标记清晰度问题。
  • 补充与分类：列出缺少意图摘要或战略分类的目标，以及项目缺陷列表。
适用场景
适合希望让 Claude Code、Cursor、Codex 等编码代理从共享目标看板领取任务、而非临时提示的场景，并需要可复核的代理计划、改动与测试记录。
运行要求
需要连接 mcp.planwright.tools 的远程 Streamable HTTP 端点，无需自托管或本地安装。使用 OAuth 2.1 与动态客户端注册，首次连接时在浏览器用 GitHub 登录；CI/CD 或无头环境可在设置中生成静态令牌。需要一个已关联 GitHub 的项目。
安装前请注意
需要 GitHub 账号登录或静态 MCP 令牌，可访问你的看板。代理可创建、更新和删除计划与目标，并可上传或覆盖上下文文件，会改变共享项目状态。差异、测试结果和上下文文件会上传到第三方托管服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 PlanWright，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/tools.planwright%2Fplanwright/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "planwright": {
      "type": "http",
      "url": "https://mcp.planwright.tools/mcp"
    }
  }
}

README

Planwright

Control plane for autonomous software labor.

Planwright is the objective-native planning board for agent-led software development. Humans define outcomes at the Objective layer; coding agents (Claude Code, Cursor, Codex, and others) claim work, decompose tasks, execute, and report back via native MCP—with every state change captured in a hash-chained, Ed25519-signed audit trail.

[Documentation] [MCP]

Quick Start

Claude Code (recommended)

bash
claude mcp add planwright https://mcp.planwright.tools/mcp

Your browser opens for GitHub login. That's it.

Other Agents

See the full agent setup guides for Cursor, Codex, Claude Desktop, and generic MCP clients.

How It Works

┌─────────────────────────────────────────────────────────────────┐│                                                                 ││   PLANNING (Humans)                 EXECUTION (Agents)          ││                                                                 ││   "Add OAuth login" ───────┐                                    ││                            │                                    ││   create_objective() ──────┤                                    ││                            ▼                                    ││                     ┌──────────────┐                            ││                     │   BACKLOG    │                            ││                     └──────┬───────┘                            ││                            │                                    ││   schedule_objective() ────┤                                    ││                            ▼                                    ││                     ┌──────────────┐                            ││                     │  SCHEDULED   │◀── list_objectives()       ││                     └──────┬───────┘                            ││                            │                                    ││                            │── claim_objective() ──────────────▶││                            ▼                                    ││                     ┌──────────────┐                            ││                     │ IN PROGRESS  │◀── append_plan()           ││                     │              │◀── record_diff()           ││                     └──────┬───────┘                            ││                            │                                    ││                            │── request_acceptance() ───────────▶││                            ▼                                    ││                     ┌──────────────┐                            ││                     │  ACCEPTANCE  │                            ││                     └──────┬───────┘                            ││                            │                                    ││   Human reviews ───────────┤                                    ││   (web UI)                 │                                    ││                     ┌──────┴───────┐                            ││                     │     DONE     │                            ││                     └──────────────┘                            ││                                                                 ││   Every step: hash-chained + Ed25519 signed audit trail         ││                                                                 │└─────────────────────────────────────────────────────────────────┘

Key Features

Objective-Native, Not Task-Based No story points. No velocity charts. No capacity planning. Agents decompose objectives into tasks themselves—you manage outcomes, not effort.

Immutable Audit Trail Every state change produces a hash-chained, Ed25519-signed audit record. Know exactly what the agent planned, what it changed, and when.

Native MCP Integration Agents connect via the Model Context Protocol—no custom API clients needed. Works with any MCP-compatible agent.

Multi-Agent Support Claude Code, Cursor, Codex, Factory, Amp—if it speaks MCP, it can work from your Planwright board.

Context Files Push CLAUDE.md, architecture docs, and specs to Planwright. Agents read them before starting work.

Documentation

Examples

See the examples/ directory for:

  • Sample CLAUDE.md files for different project types
  • Example objective structures
  • Context file templates

MCP Server

Planwright's MCP server is hosted and managed—no self-hosting required.

EndpointProtocol
https://mcp.planwright.tools/mcpStreamable HTTP

Authentication is handled via OAuth 2.1 with Dynamic Client Registration (RFC 7591). Your agent opens a browser for GitHub login on first connection.

For CI/CD and headless environments, generate a static token in Settings → MCP Tokens.

Available Tools

Planwright exposes 30 MCP tools for agent orchestration:

Setup & Context

ToolDescription
planwright_set_repoSet active project for the session (by GitHub repo or project ID)
planwright_list_workspacesList workspaces you have access to
planwright_list_projectsList projects with IDs and linked GitHub repos
planwright_list_context_filesList CLAUDE.md, specs, architecture docs for the project
planwright_get_context_fileRead a specific context file
planwright_push_context_fileUpload or update a context file
planwright_get_doc_suggestionsGet pending documentation gap suggestions
planwright_dismiss_doc_suggestionDismiss a doc suggestion
planwright_get_board_urlGet the Planwright board URL

Initiatives

ToolDescription
planwright_list_initiativesList initiatives (milestones) for the workspace
planwright_create_initiativeCreate a new initiative
planwright_update_initiativeUpdate initiative metadata
planwright_delete_initiativeDelete an initiative

Objectives

ToolDescription
planwright_list_objectivesList objectives by lane (backlog, scheduled, in_progress, acceptance, done)
planwright_get_objectiveGet full objective details including agent run history
planwright_create_objectiveCreate a new objective with acceptance criteria
planwright_update_objectiveUpdate objective metadata
planwright_schedule_objectiveMove objective from backlog to scheduled

Agent Workflow

ToolDescription
planwright_claim_objectiveClaim a scheduled objective and start an agent run
planwright_append_planPost the agent's decomposition plan
planwright_check_alignmentVerify work aligns with claimed objective (drift detection)
planwright_record_diffRecord diff summary and test results
planwright_submit_test_runSubmit acceptance criteria verification results
planwright_request_acceptanceMove objective to acceptance lane for human review
planwright_append_noteRecord task completion in the agent run log
planwright_flag_clarityFlag objective as having clarity concerns
planwright_override_clarityHuman override for clarity flags

Enrichment & Classification

ToolDescription
planwright_list_unenrichedList objectives/initiatives missing intent summaries
planwright_list_unclassifiedList objectives missing strategic classification
planwright_list_my_bugsList bugs for this project

Support

License

Planwright is a commercial product. The MCP integration examples in this repository are provided under the MIT License.

See LICENSE for details.

来源：README.md，提交 a7b1106

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v1.0.2最新Sep 16, 2026

评分

已满足适用检查项的 75%

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

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。