Planwright
The planning board coding agents were waiting for.
Planwright is the objective-native planning board for agent-led software development. Humans manage at the Objective layer; coding agents (Claude Code, Cursor, Codex, and others) decompose, execute, and report back via a native MCP server.
Quick Start
Claude Code (recommended)
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.mdfiles for different project types - Example objective structures
- Context file templates
MCP Server
Planwright's MCP server is hosted and managed—no self-hosting required.
| Endpoint | Protocol | Use Case |
|---|---|---|
https://mcp.planwright.tools/mcp | Streamable HTTP | Recommended for all agents |
https://mcp.planwright.tools/sse | SSE | Legacy fallback |
Authentication is handled via OAuth 2.1. 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.
Support
License
Planwright is a commercial product. The MCP integration examples in this repository are provided under the MIT License.
See LICENSE for details.