pmpt-cli 1.5.2 → 1.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pmptwiki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,10 +1,49 @@
+<div align="center">
+
 # pmpt
 
-**Record and share your AI-driven product development journey.**
+**Answer 5 questions. Start building with AI.**
+
+[![npm version](https://img.shields.io/npm/v/pmpt-cli.svg?style=flat-square&color=cb3837)](https://www.npmjs.com/package/pmpt-cli)
+[![license](https://img.shields.io/github/license/pmptwiki/pmpt-cli?style=flat-square&v=2)](https://github.com/pmptwiki/pmpt-cli/blob/main/LICENSE)
+[![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square)](https://github.com/pmptwiki/pmpt-cli)
+
+The CLI that turns your idea into an AI-ready prompt in 30 seconds.
 
-[![npm version](https://img.shields.io/npm/v/pmpt-cli.svg)](https://www.npmjs.com/package/pmpt-cli)
+No coding required. No complex setup. Just answer 5 questions.
 
-**Website**: [pmptwiki.com](https://pmptwiki.com)
+[Quick Start](#quick-start) · [Commands](#commands) · [How It Works](#how-it-works) · [Explore Projects](#explore-projects)
+
+</div>
+
+---
+
+## Demo
+
+```
+$ pmpt plan
+
+┌  pmpt — Let's plan your product!
+│
+◆  What should we call your project?
+│  my-budget-app
+│
+◆  What would you like to build with AI?
+│  A personal budget tracking app for freelancers
+│
+◆  Any additional context AI should know? (optional)
+│  Simple UI, mobile-friendly, works offline
+│
+◆  Key features to include?
+│  Expense tracking; Income categories; Monthly reports; Export to CSV
+│
+◆  Preferred tech stack? (optional)
+│  React, Node.js
+│
+└  Done! AI prompt copied to clipboard.
+
+→ Open Claude / ChatGPT / Cursor → Ctrl+V → Start building!
+```
 
 ---
 
@@ -14,35 +53,59 @@
 npm install -g pmpt-cli
 ```
 
+> Requires Node.js 18+
+
 ---
 
 ## Quick Start
 
 ```bash
-# 1. Initialize project
+# 1. Install
+npm i -g pmpt-cli
+
+# 2. Initialize your project
 pmpt init
 
-# 2. Answer 5 questions → AI prompt generated
+# 3. Answer 5 questions → AI prompt auto-generated & copied
 pmpt plan
 
-# 3. Copy the prompt to Claude/ChatGPT/Cursor and build!
+# 4. Paste into Claude / ChatGPT / Cursor → Build your product!
 
-# 4. Save your progress
+# 5. Save your progress anytime
 pmpt save
 
-# 5. Publish to pmptwiki
-pmpt login
-pmpt publish
+# 6. Share with the community
+pmpt login && pmpt publish
+
+# Bonus: Explore what others are building
+pmpt browse
 ```
 
 ---
 
 ## Why pmpt?
 
-- **5 questions** — Quick product planning with AI-ready prompts
-- **Version history** — Track every step of your AI-assisted development
-- **Share & reproduce** — Publish projects for others to learn from and clone
-- **Project hub** — Browse and clone projects at [pmptwiki.com](https://pmptwiki.com/explore)
+| | 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.
 
 ---
 
@@ -52,72 +115,95 @@ pmpt publish
 
 | Command | Description |
 |---------|-------------|
-| `pmpt init` | Initialize project |
-| `pmpt plan` | 5 questions → AI prompt (copied to clipboard) |
-| `pmpt save` | Save current state as snapshot |
-| `pmpt watch` | Auto-detect file changes |
+| `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 and tracked files |
 | `pmpt history` | View version history |
-| `pmpt history --compact` | Hide minor changes |
-| `pmpt squash v2 v5` | Merge versions v2-v5 into v2 |
-| `pmpt export` | Export as `.pmpt` file (single JSON) |
+| `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 status` | Check project status |
 
 ### Platform
 
 | Command | Description |
 |---------|-------------|
-| `pmpt login` | Authenticate with GitHub (one-time setup) |
-| `pmpt publish` | Publish project to pmptwiki |
-| `pmpt clone <slug>` | Clone a published project |
-| `pmpt browse` | Browse and discover projects |
+| `pmpt login` | Authenticate via GitHub (one-time) |
+| `pmpt publish` | Publish your project for others to discover |
+| `pmpt edit` | Edit published project metadata (description, tags, category) |
+| `pmpt unpublish` | Remove a published project from pmptwiki |
+| `pmpt clone <slug>` | Clone and reproduce someone's project |
+| `pmpt browse` | Browse and search published projects |
+
+> See the full documentation at [pmptwiki.com/docs](https://pmptwiki.com/docs)
 
 ---
 
-## Workflow
+## How It Works
 
 ```
-[You]
-  │
-  ├─ pmpt plan ─────→ 5 questions → AI prompt (clipboard)
-  │
-  ├─ Build with AI ──→ Create files, iterate
-  │
-  ├─ pmpt save ─────→ Save to .pmpt/.history
-  │
-  ├─ pmpt publish ──→ Share on pmptwiki.com
-  │
-  └─ pmpt clone ────→ Reproduce someone's project
+  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     │
 ```
 
 ---
 
-## Folder Structure
+## Project Structure
 
 ```
-.pmpt/
-├── config.json           # Config file
-├── docs/                 # Working folder (MD files)
-│   ├── plan.md           # Product plan
-│   └── pmpt.md           # AI prompt
-└── .history/             # Version history
-    ├── v1-2024-02-20/
-    ├── v2-2024-02-21/
-    └── ...
+your-project/
+└── .pmpt/
+    ├── config.json        # Project configuration
+    ├── docs/              # Generated documents
+    │   ├── plan.md        # Product plan (features checklist)
+    │   └── pmpt.md        # AI-ready prompt
+    └── .history/          # Auto-saved version history
+        ├── v1-2024-02-20/
+        ├── v2-2024-02-21/
+        └── ...
 ```
 
 ---
 
 ## .pmpt File Format
 
-Single JSON file containing your entire development journey:
+A single portable file containing your entire development journey:
 
 ```json
 {
   "schemaVersion": "1.0",
-  "meta": { "projectName": "", "description": "", "createdAt": "" },
-  "plan": { "productIdea": "", "coreFeatures": "", "techStack": "" },
-  "docs": { "plan.md": "...", "pmpt.md": "..." },
+  "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": "..."
+  },
   "history": [
     { "version": 1, "timestamp": "...", "files": {} },
     { "version": 2, "timestamp": "...", "files": {} }
@@ -125,26 +211,63 @@ Single JSON file containing your entire development journey:
 }
 ```
 
+Share it. Clone it. Reproduce it.
+
 ---
 
 ## Use Cases
 
-- **Side project builders** — Track your AI-assisted development
-- **Startup founders** — Document MVP creation process
-- **Content creators** — Share your coding journey
-- **Learners** — Browse and clone projects to study how others build with AI
+- **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? Browse what others have created with AI.
+
+```bash
+# Discover projects from the community
+pmpt browse
+
+# Found something interesting? Clone it and make it yours
+pmpt clone budget-tracker-app
+```
+
+**[Explore Projects on pmptwiki.com →](https://pmptwiki.com/explore)**
+
+See how others planned their products, what prompts they used, and how their projects evolved step by step. Clone any project and use it as a starting point for your own.
+
+---
+
+## Contributing
+
+Contributions are welcome! Feel free to open an [issue](https://github.com/pmptwiki/pmpt-cli/issues) or submit a [pull request](https://github.com/pmptwiki/pmpt-cli/pulls).
 
 ---
 
 ## Links
 
-- [Website](https://pmptwiki.com)
-- [Explore Projects](https://pmptwiki.com/explore)
 - [GitHub](https://github.com/pmptwiki/pmpt-cli)
 - [npm](https://www.npmjs.com/package/pmpt-cli)
+- [Documentation](https://pmptwiki.com/docs)
 
 ---
 
 ## License
 
-MIT
+[MIT](https://github.com/pmptwiki/pmpt-cli/blob/main/LICENSE)
+
+---
+
+<div align="center">
+
+**If pmpt helps you build something, give it a ⭐**
+
+[Explore what others are building →](https://pmptwiki.com/explore)
+
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow?style=flat-square&logo=buy-me-a-coffee)](https://buymeacoffee.com/pmpt_cafe)
+
+</div>

package/dist/commands/edit.js

@@ -0,0 +1,99 @@
+import * as p from '@clack/prompts';
+import { loadAuth } from '../lib/auth.js';
+import { fetchProjects, editProject } from '../lib/api.js';
+export async function cmdEdit() {
+    const auth = loadAuth();
+    if (!auth?.token || !auth?.username) {
+        p.log.error('Login required. Run `pmpt login` first.');
+        process.exit(1);
+    }
+    p.intro('pmpt edit');
+    const s = p.spinner();
+    s.start('Loading your projects...');
+    let myProjects;
+    try {
+        const index = await fetchProjects();
+        myProjects = index.projects.filter((proj) => proj.author === auth.username);
+    }
+    catch (err) {
+        s.stop('Failed to load projects');
+        p.log.error(err instanceof Error ? err.message : 'Failed to fetch projects.');
+        process.exit(1);
+    }
+    s.stop('Projects loaded');
+    if (myProjects.length === 0) {
+        p.log.warn('No published projects found. Run `pmpt publish` first.');
+        p.outro('');
+        return;
+    }
+    const slug = await p.select({
+        message: 'Select a project to edit:',
+        options: myProjects.map((proj) => ({
+            value: proj.slug,
+            label: proj.slug,
+            hint: proj.description?.slice(0, 50) || '',
+        })),
+    });
+    if (p.isCancel(slug)) {
+        p.cancel('Cancelled');
+        process.exit(0);
+    }
+    const project = myProjects.find((proj) => proj.slug === slug);
+    const description = await p.text({
+        message: 'Description:',
+        defaultValue: project.description,
+        placeholder: project.description,
+    });
+    if (p.isCancel(description)) {
+        p.cancel('Cancelled');
+        process.exit(0);
+    }
+    const tagsInput = await p.text({
+        message: 'Tags (comma-separated):',
+        defaultValue: project.tags.join(', '),
+        placeholder: project.tags.join(', '),
+    });
+    if (p.isCancel(tagsInput)) {
+        p.cancel('Cancelled');
+        process.exit(0);
+    }
+    const tags = tagsInput
+        .split(',')
+        .map((t) => t.trim().toLowerCase())
+        .filter(Boolean);
+    const category = await p.select({
+        message: 'Category:',
+        initialValue: project.category || 'other',
+        options: [
+            { value: 'web-app', label: 'Web App' },
+            { value: 'mobile-app', label: 'Mobile App' },
+            { value: 'cli-tool', label: 'CLI Tool' },
+            { value: 'api-backend', label: 'API/Backend' },
+            { value: 'ai-ml', label: 'AI/ML' },
+            { value: 'game', label: 'Game' },
+            { value: 'library', label: 'Library' },
+            { value: 'other', label: 'Other' },
+        ],
+    });
+    if (p.isCancel(category)) {
+        p.cancel('Cancelled');
+        process.exit(0);
+    }
+    const s2 = p.spinner();
+    s2.start('Updating...');
+    try {
+        await editProject(auth.token, slug, {
+            description: description,
+            tags,
+            category: category,
+        });
+        s2.stop('Updated!');
+        p.log.success(`Project "${slug}" has been updated.`);
+    }
+    catch (err) {
+        s2.stop('Update failed');
+        p.log.error(err instanceof Error ? err.message : 'Failed to update project.');
+        process.exit(1);
+    }
+    p.outro('');
+}

package/dist/commands/publish.js

@@ -6,7 +6,7 @@ import { getAllSnapshots, resolveFullSnapshot } from '../lib/history.js';
 import { getPlanProgress } from '../lib/plan.js';
 import { createPmptFile } from '../lib/pmptFile.js';
 import { loadAuth } from '../lib/auth.js';
-import { publishProject } from '../lib/api.js';
+import { publishProject, fetchProjects } from '../lib/api.js';
 import glob from 'fast-glob';
 import { join } from 'path';
 function readDocsFolder(docsDir) {
@@ -43,10 +43,23 @@ export async function cmdPublish(path) {
         return;
     }
     const projectName = planProgress?.answers?.projectName || basename(projectPath);
+    // Try to load existing published data for prefill
+    let existing;
+    const savedSlug = config?.lastPublishedSlug;
+    try {
+        const index = await fetchProjects();
+        if (savedSlug) {
+            existing = index.projects.find((p) => p.slug === savedSlug && p.author === auth.username);
+        }
+    }
+    catch { /* ignore — first publish or offline */ }
+    const defaultSlug = savedSlug
+        || projectName.toLowerCase().replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-');
     // Collect publish info
     const slug = await p.text({
         message: 'Project slug (used in URL):',
-        placeholder: projectName.toLowerCase().replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-'),
+        placeholder: defaultSlug,
+        defaultValue: savedSlug || '',
         validate: (v) => {
             if (!/^[a-z0-9][a-z0-9-]{1,48}[a-z0-9]$/.test(v)) {
                 return '3-50 chars, lowercase letters, numbers, and hyphens only.';
@@ -59,8 +72,8 @@ export async function cmdPublish(path) {
     }
     const description = await p.text({
         message: 'Project description (brief):',
-        placeholder: planProgress?.answers?.productIdea?.slice(0, 100) || '',
-        defaultValue: planProgress?.answers?.productIdea?.slice(0, 200) || '',
+        placeholder: existing?.description || planProgress?.answers?.productIdea?.slice(0, 100) || '',
+        defaultValue: existing?.description || planProgress?.answers?.productIdea?.slice(0, 200) || '',
     });
     if (p.isCancel(description)) {
         p.cancel('Cancelled');
@@ -69,7 +82,7 @@ export async function cmdPublish(path) {
     const tagsInput = await p.text({
         message: 'Tags (comma-separated):',
         placeholder: 'react, saas, mvp',
-        defaultValue: '',
+        defaultValue: existing?.tags?.join(', ') || '',
     });
     if (p.isCancel(tagsInput)) {
         p.cancel('Cancelled');
@@ -81,6 +94,7 @@ export async function cmdPublish(path) {
         .filter(Boolean);
     const category = await p.select({
         message: 'Project category:',
+        initialValue: existing?.category || 'other',
         options: [
             { value: 'web-app', label: 'Web App' },
             { value: 'mobile-app', label: 'Mobile App' },
@@ -155,6 +169,7 @@ export async function cmdPublish(path) {
         // Update config
         if (config) {
             config.lastPublished = new Date().toISOString();
+            config.lastPublishedSlug = slug;
             saveConfig(projectPath, config);
         }
         p.note([

package/dist/commands/unpublish.js

@@ -0,0 +1,62 @@
+import * as p from '@clack/prompts';
+import { loadAuth } from '../lib/auth.js';
+import { fetchProjects, unpublishProject } from '../lib/api.js';
+export async function cmdUnpublish() {
+    const auth = loadAuth();
+    if (!auth?.token || !auth?.username) {
+        p.log.error('Login required. Run `pmpt login` first.');
+        process.exit(1);
+    }
+    p.intro('pmpt unpublish');
+    const s = p.spinner();
+    s.start('Loading your projects...');
+    let myProjects;
+    try {
+        const index = await fetchProjects();
+        myProjects = index.projects.filter((proj) => proj.author === auth.username);
+    }
+    catch (err) {
+        s.stop('Failed to load projects');
+        p.log.error(err instanceof Error ? err.message : 'Failed to fetch projects.');
+        process.exit(1);
+    }
+    s.stop('Projects loaded');
+    if (myProjects.length === 0) {
+        p.log.warn('No published projects found.');
+        p.outro('');
+        return;
+    }
+    const slug = await p.select({
+        message: 'Select a project to remove:',
+        options: myProjects.map((proj) => ({
+            value: proj.slug,
+            label: proj.slug,
+            hint: proj.description?.slice(0, 50) || '',
+        })),
+    });
+    if (p.isCancel(slug)) {
+        p.cancel('Cancelled');
+        process.exit(0);
+    }
+    const confirm = await p.confirm({
+        message: `Delete "${slug}" from pmptwiki? This cannot be undone.`,
+        initialValue: false,
+    });
+    if (p.isCancel(confirm) || !confirm) {
+        p.cancel('Cancelled');
+        process.exit(0);
+    }
+    const s2 = p.spinner();
+    s2.start('Removing...');
+    try {
+        await unpublishProject(auth.token, slug);
+        s2.stop('Removed!');
+        p.log.success(`Project "${slug}" has been removed from pmptwiki.`);
+    }
+    catch (err) {
+        s2.stop('Remove failed');
+        p.log.error(err instanceof Error ? err.message : 'Failed to remove project.');
+        process.exit(1);
+    }
+    p.outro('');
+}

package/dist/index.js

@@ -11,6 +11,8 @@ import { cmdExport } from './commands/export.js';
 import { cmdImport } from './commands/import.js';
 import { cmdLogin } from './commands/login.js';
 import { cmdPublish } from './commands/publish.js';
+import { cmdEdit } from './commands/edit.js';
+import { cmdUnpublish } from './commands/unpublish.js';
 import { cmdClone } from './commands/clone.js';
 import { cmdBrowse } from './commands/browse.js';
 const program = new Command();
@@ -94,6 +96,14 @@ program
     .command('publish [path]')
     .description('Publish project to pmptwiki platform')
     .action(cmdPublish);
+program
+    .command('edit')
+    .description('Edit published project metadata (description, tags, category)')
+    .action(cmdEdit);
+program
+    .command('unpublish')
+    .description('Remove a published project from pmptwiki')
+    .action(cmdUnpublish);
 program
     .command('clone <slug>')
     .description('Clone a project from pmptwiki platform')

package/dist/lib/api.js

@@ -48,6 +48,32 @@ export async function fetchProjects() {
     }
     return res.json();
 }
+export async function editProject(token, slug, data) {
+    const res = await fetch(`${API_BASE}/publish/${slug}`, {
+        method: 'PATCH',
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(data),
+    });
+    if (!res.ok) {
+        const err = await res.json().catch(() => ({ error: 'Edit failed' }));
+        throw new Error(err.error);
+    }
+}
+export async function unpublishProject(token, slug) {
+    const res = await fetch(`${API_BASE}/publish/${slug}`, {
+        method: 'DELETE',
+        headers: {
+            Authorization: `Bearer ${token}`,
+        },
+    });
+    if (!res.ok) {
+        const err = await res.json().catch(() => ({ error: 'Unpublish failed' }));
+        throw new Error(err.error);
+    }
+}
 export async function fetchPmptFile(slug) {
     const res = await fetch(`${R2_PUBLIC_URL}/projects/${slug}.pmpt`);
     if (!res.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmpt-cli",
-  "version": "1.5.2",
+  "version": "1.6.0",
   "description": "Record and share your AI-driven product development journey",
   "type": "module",
   "bin": {