pmpt

Name: pmpt-mcp
Author: pmptwiki

Record and share your AI-driven product development journey.

npm version license node

Plan with 5 questions. Build with AI. Save every version. Share and reproduce.

Quick Start · Commands · MCP Server · Explore Projects

Demo

Answer 5 questions → AI prompt auto-generated & copied to clipboard → Paste into Claude Code / Codex / Cursor → Start building!

Install

npm install -g pmpt-cli

Requires Node.js 18+

Quick Start

# 1. Install
npm i -g pmpt-cli

# 2. Initialize your project
pmpt init

# 3. Answer 5 questions → AI prompt auto-generated & copied
pmpt plan

# 4. Paste into Claude Code / Codex / Cursor → Build your product!

# 5. Save your progress anytime
pmpt save

# 6. Share with the community
pmpt login && pmpt publish

# Bonus: Explore what others are building
pmpt explore

Why pmpt?

	Without pmpt	With pmpt
Planning	Stare at blank screen, write vague prompts	Answer 5 guided questions, get structured AI prompt
Tracking	Lose track of what you built and how	Every version auto-saved with full history
Sharing	Share finished code only	Share the entire journey — others can reproduce it

The 5 Questions

pmpt plan asks just 5 questions to generate a complete AI prompt:

#	Question	Example
1	Project name	`my-budget-app`
2	What to build	`A budget tracking app for freelancers`
3	Additional context (optional)	`Simple UI, mobile-friendly`
4	Key features	`Expense tracking; Monthly reports; CSV export`
5	Tech stack (optional)	`React, Node.js` — or let AI decide

The generated prompt is automatically copied to your clipboard. Just paste it into your favorite AI tool.

Commands

Local

Command	Description
`pmpt init`	Initialize project and start tracking
`pmpt plan`	5 questions → AI prompt (auto-copied to clipboard)
`pmpt save`	Save current state as a snapshot
`pmpt watch`	Auto-detect file changes and save versions
`pmpt status`	Check project status, tracked files, and quality score
`pmpt history`	View version history
`pmpt diff v1 v2`	Compare two versions (unified diff)
`pmpt diff v3`	Compare version vs working copy
`pmpt squash v2 v5`	Merge versions v2–v5 into one
`pmpt export`	Export project as `.pmpt` file
`pmpt import <file>`	Import from `.pmpt` file
`pmpt recover`	Recover damaged pmpt.md via AI-generated prompt
`pmpt mcp-setup`	Auto-configure MCP server for your AI tool
`pmpt -v`	Show current CLI version

Platform

Command	Description
`pmpt login`	Authenticate via GitHub (one-time)
`pmpt publish`	Publish your project (requires quality score ≥ 40)
`pmpt update`	Quick re-publish: update content without changing metadata
`pmpt edit`	Edit published project metadata (description, tags, category, visibility, related projects, product URL)
`pmpt unpublish`	Remove a published project from pmptwiki
`pmpt graduate`	Graduate a project — archive with badge, move to Hall of Fame
`pmpt clone <slug>`	Clone and reproduce someone's project
`pmpt explore`	Open pmptwiki.com/explore in your browser

Quality score below 40? pmpt copies an AI improvement prompt to your clipboard — paste it into your AI tool to get help improving your project.

See the full documentation at pmptwiki.com/docs

MCP Server

pmpt includes a built-in MCP server so AI tools can interact with pmpt directly. This means Claude Code, Cursor, and other MCP-compatible tools can save snapshots, check status, and review history without you typing commands.

Setup

pmpt-mcp is included when you install pmpt — no separate installation needed.

npm install -g pmpt-cli   # pmpt + pmpt-mcp both installed

Automatic Setup (Recommended)

pmpt mcp-setup

Auto-detects the pmpt-mcp binary path, lets you choose your AI tool (Claude Code, Cursor, or .mcp.json), and writes the config. Solves PATH issues common with nvm.

Manual Setup

Add to your .mcp.json (or IDE MCP config):

{
  "mcpServers": {
    "pmpt": {
      "command": "pmpt-mcp"
    }
  }
}

nvm users: If your AI tool can't find pmpt-mcp, use pmpt mcp-setup or replace "pmpt-mcp" with the absolute path (run which pmpt-mcp to find it).

Available Tools

Tool	Description
`pmpt_plan_questions`	Get planning questions to ask the user conversationally
`pmpt_plan`	Submit answers to generate AI prompt and project docs
`pmpt_save`	Save a snapshot with detailed summary
`pmpt_update_doc`	Check off features, add progress notes, backfill summaries
`pmpt_log_decision`	Record architectural/technical decisions with reasoning
`pmpt_read_context`	Read full project context (plan, docs, history, quality)
`pmpt_status`	Check tracked files, snapshot count, and quality score
`pmpt_history`	View version history with git commit info
`pmpt_diff`	Compare two versions, or a version against working copy
`pmpt_edit_plan`	Edit plan fields — regenerates plan.md and pmpt.ai.md
`pmpt_quality`	Check quality score and publish readiness
`pmpt_publish`	Publish project to pmptwiki.com

All tools accept an optional projectPath parameter (defaults to cwd).

How It Works

  You                          pmpt                         AI Tool
   │                            │                              │
   ├── pmpt init ──────────────→│                              │
   │                            │  Creates .pmpt/ project      │
   │                            │                              │
   ├── pmpt plan ──────────────→│                              │
   │   (answer 5 questions)     │  Generates AI prompt         │
   │                            │  → Copied to clipboard       │
   │                            │                              │
   ├── Ctrl+V ─────────────────────────────────────────────────→│
   │                            │                    Builds your product
   │                            │                              │
   ├── pmpt save ──────────────→│                              │
   │                            │  Snapshots version history   │
   │                            │                              │
   ├── pmpt publish ───────────→│                              │
   │                            │  Shares with community       │
   │                            │                              │
   └── Others: pmpt clone ─────→│  Reproduces your journey     │

Project Structure

your-project/
└── .pmpt/
    ├── config.json        # Project configuration
    ├── docs/              # Generated documents
    │   ├── plan.md        # Product plan (features checklist)
    │   ├── pmpt.md        # Progress tracking & decisions
    │   └── pmpt.ai.md     # AI-ready prompt (project context & instructions)
    └── .history/          # Auto-saved version history
        ├── v1-2024-02-20/
        ├── v2-2024-02-21/
        └── ...

.pmpt File Format

A single portable file containing your entire development journey:

{
  "schemaVersion": "1.0",
  "meta": {
    "projectName": "my-budget-app",
    "description": "Budget tracking app for freelancers",
    "createdAt": "2024-02-20T10:00:00Z"
  },
  "plan": {
    "productIdea": "A budget tracking app...",
    "coreFeatures": "Expense tracking; Monthly reports",
    "techStack": "React, Node.js"
  },
  "docs": {
    "plan.md": "...",
    "pmpt.md": "...",
    "pmpt.ai.md": "..."
  },
  "history": [
    { "version": 1, "timestamp": "...", "files": {} },
    { "version": 2, "timestamp": "...", "files": {} }
  ]
}

Share it. Clone it. Reproduce it.

Use Cases

Have an idea but no coding skills? — Answer 5 questions, paste the prompt into AI, and start building
Startup founders — Document your MVP creation process from day one
Content creators — Share your AI-assisted building journey as reproducible content
Learners — Clone published projects to study how others build with AI

Explore Projects

Don't know what to build? See what others have created with AI.

# Open the explore page
pmpt explore

# Found something interesting? Clone it and make it yours
pmpt clone budget-tracker-app

Explore Projects on pmptwiki.com →

Clone any project to see how it was planned, what prompts were used, and how it evolved step by step. The clone output shows the product idea, tech stack, and full version history.

Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

License

MIT

If pmpt helps you build something, give it a ⭐

Explore what others are building →

Buy Me A Coffee

pmpt-mcp