<div align="center">
pmpt
Record and share your AI-driven product development journey.
  
Plan with 5 questions. Build with AI. Save every version. Share and reproduce.
Quick Start · Commands · MCP Server · Explore Projects
</div>
---
Demo
<img src="./demo.gif" alt="pmpt plan demo" width="600" />
Answer 5 questions → AI prompt auto-generated & copied to clipboard → Paste into Claude Code / Codex / Cursor → Start building!
---
Install
npm install -g pmpt-cliRequires 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 installedAutomatic Setup (Recommended)
pmpt mcp-setupAuto-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, usepmpt mcp-setupor replace"pmpt-mcp"with the absolute path (runwhich pmpt-mcpto 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-appExplore 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.
---
Links
---
License
---
<div align="center">
If pmpt helps you build something, give it a ⭐
Explore what others are building →
</div>
