prpm 1.0.3 → 1.1.0

package/README.md

@@ -1,428 +1,156 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/pr-pm/prpm/main/packages/webapp/public/logo.svg" alt="PRPM Logo" width="200" />
+</p>
+
 # PRPM - The Package Manager for AI Prompts
 
-**The largest collection of Cursor rules, Claude agents, and slash commands.** Install cursor slash commands, claude slash commands, cursor rules, claude agents, and claude plugins like npm packages.
+The universal registry for AI coding tools.
+
+Discover and install cross-platform prompts, rules, skills, and agents that work with Cursor, Claude, Continue, Windsurf, GitHub Copilot, OpenAI Codex, Google Gemini, Kiro, and more — all from one file.
 
 ```bash
 npm install -g prpm
-prpm install collection/nextjs-pro  # Entire Next.js setup in one command
+prpm install collections/nextjs-pro  # Entire Next.js setup in one command
 ```
+Installs 20 packages: backend-architect, cloud-architect, database-architect, and more
 
-**2,100+ packages** | **Works everywhere** (Cursor, Claude, Continue, Windsurf, GitHub Copilot, Kiro) | **One command to install**
+7,5000+ cross platform packages
 
-📚 **[Official Documentation](https://docs.prpm.dev)** | 🌐 **[Browse Packages](https://prpm.dev)**
+[Docs](https://docs.prpm.dev) | [Search Packages](https://prpm.dev/search) | [Search Collections](https://prpm.dev/search?tab=collections)
 
 ---
 
-## 📦 Collections - Complete Setups in One Command
-
-Skip installing packages one-by-one. Get curated bundles for your entire workflow:
-
-```bash
-# Install 5+ packages at once
-prpm install collection/nextjs-pro
-# → Installs react-best-practices, typescript-strict, tailwind-helper,
-#    nextjs-patterns, component-architect
-
-# Python data science stack
-prpm install collection/python-data
-# → Installs pandas-helper, numpy-patterns, matplotlib-guide,
-#    jupyter-best-practices, ml-workflow
-
-# Full-stack React
-prpm install collection/react-fullstack
-# → Everything for React + Node + PostgreSQL (8 packages)
-```
+![demo](https://raw.githubusercontent.com/pr-pm/prpm/main/packages/webapp/public/demo.gif)
 
-**[Browse Collections →](https://prpm.dev/search?tab=collections)**
+## Self Improve
+Give your IDE the ability to self improve by installing packages that it finds useful:
+![self-improve-demo](https://raw.githubusercontent.com/pr-pm/prpm/main/packages/webapp/public/self-improve.gif)
 
 ---
 
-## 🔄 Universal Packages - Install Once, Use Anywhere
+## Universal Packages - Install Once, Use Anywhere
 
 Every package works in **any** AI editor. No conversion tools, no separate downloads:
 
 ```bash
 # Same package, different editors
-prpm install @username/react-best-practices --as cursor    # → .cursor/rules/
-prpm install @username/react-best-practices --as claude    # → .claude/agents/
-prpm install @username/react-best-practices --as continue  # → .continue/prompts/
-prpm install @username/react-best-practices --as windsurf  # → .windsurf/rules/
-prpm install @username/react-best-practices --as copilot   # → .github/instructions/
-prpm install @username/react-best-practices --as kiro      # → .kiro/steering/
-
-# Or just let PRPM auto-detect
-prpm install @username/react-best-practices  # Installs in the right place automatically
+prpm install @sanjeed5/react --as cursor                    # → .cursor/rules/
+prpm install @sanjeed5/react --as claude --subtype agent    # → .claude/agents/
+prpm install @sanjeed5/react --as continue                  # → .continue/prompts/
+prpm install @sanjeed5/react --as windsurf                  # → .windsurf/rules/
+prpm install @sanjeed5/react --as copilot                   # → .github/instructions/
+prpm install @sanjeed5/react --as kiro                      # → .kiro/steering/
 ```
 
-**Format conversion happens server-side.** Authors publish once, users install everywhere.
+## Discovery - Find What You Need
 
----
+Browse packages with powerful discovery:
 
-## Why PRPM?
-
-### The Problem
 ```bash
-# Current workflow (painful)
-1. Find cursor rule on GitHub
-2. Copy raw file URL
-3. Create .cursor/rules/something.md
-4. Paste content
-5. Repeat for every rule
-6. Update manually when rules change
-7. Do it all again for Claude/Continue/Windsurf
-```
-
-### The Solution
-```bash
-# PRPM workflow (simple)
-prpm install collection/nextjs-pro  # Entire setup (multiple packages)
-# OR
-prpm install @username/test-driven-development  # Single package
-prpm install @username/systematic-debugging
-```
-
-**It's npm for AI prompts. But it works everywhere.**
-
-### Team Consistency
-
-If you're working on a big project and some coworkers use Copilot, others use Claude, and sometimes it's Cursor, the only way to unify rules so it's consistent across the codebase is to use PRPM. It's an easy way to make sure everyone has the same rules across the team.
-
----
-
-## Installation
-
-```bash
-# NPM (recommended)
-npm install -g prpm
-
-# Homebrew (macOS)
-brew install khaliqgant/homebrew-prpm/prpm
-```
-
----
-
-## Quick Start
-
-```bash
-# Install a complete collection
-prpm install collection/nextjs-pro
-
-# Or browse and search
+# Search by keyword
 prpm search react
-prpm trending
-prpm collections
-
-# Install individual packages
-prpm install @username/test-driven-development
-prpm install @username/react-best-practices --as cursor
-
-# Check what's installed
-prpm list
-
-# Keep packages up to date
-prpm outdated
-prpm update
-```
-
----
-
-## Commands
-
-### Collections
-```bash
-prpm collections                    # Browse available collections
-prpm collections search frontend    # Search collections
-prpm collections info collection/nextjs-pro  # View details
-prpm install collection/nextjs-pro  # Install a collection
-```
-
-### Package Management
-```bash
-prpm search react                    # Search packages
-prpm install <package-name>          # Install package
-prpm install <package> --as cursor   # Install for specific editor
-prpm list                            # List installed
-prpm uninstall <package-name>        # Remove package
-```
+prpm search "test driven development"
 
-### Discovery
-```bash
-prpm trending                        # Trending packages
-prpm popular                         # Most popular packages
-prpm info <package-name>             # Package details
-```
-
-### Updates
-```bash
-prpm outdated                        # Check for updates
-prpm update                          # Update all packages
-prpm upgrade                         # Upgrade (including major versions)
-```
+# See what's trending
+prpm trending
 
-### Publishing
-```bash
-prpm login                           # Login to registry
-prpm whoami                          # Show current user
-prpm publish                         # Publish a package
-prpm init                            # Create prpm.json
-```
+# Get detailed info
+prpm info @username/react-best-practices
+# → Shows: description, downloads, rating, tags, installation instructions
 
-### Configuration
-```bash
-prpm config set defaultFormat cursor # Set default format
-prpm config get defaultFormat        # Get config value
-prpm config list                     # List all config
+# Browse collections
+prpm collections
+prpm collections search frontend
+prpm collections info collection/nextjs-pro
 ```
 
-📚 **[Full CLI Reference](https://docs.prpm.dev/cli/commands)** | **[All Documentation](https://docs.prpm.dev)**
+[CLI Reference](https://docs.prpm.dev/cli/overview)
 
 ---
 
-## Real-World Examples
+## Playground
 
-### Complete Next.js Setup
-```bash
-prpm install collection/nextjs-pro
-# Installs 5+ packages in one command: React best practices, TypeScript config,
-# Tailwind helpers, Next.js patterns, component architecture
-```
+Test packages interactively before installing:
 
-### Switch Between Editors
 ```bash
-# Working in Cursor today
-prpm install @username/react-best-practices --as cursor
+# Try a package in the browser playground
+prpm playground --package @username/react-best-practices
 
-# Trying Claude Code tomorrow
-prpm install @username/react-best-practices --as claude
-# Same package, different format. Zero conversion work.
+# Test with different AI models
+# → Opens browser playground at prpm.dev/playground
+# → Select model: Claude 3.5 Sonnet, GPT-4, etc.
+# → Test prompt with sample code
+# → See results before installing
 ```
 
-### Get Code Reviews
-```bash
-prpm install @username/karen-skill
-# Ask in Claude Code: "Karen, review this repository"
-# Get: 78/100 score + market research + actionable fixes
-```
-
----
+**Features:**
+-  **Multi-Model Testing** - Try packages with Claude, GPT-4, and more
+-  **Free Credits** - 1,000 monthly credits for all logged in users
+-  **Live Results** - See how prompts perform in real-time
+-  **Save Sessions** - Resume testing later
+-  **Compare Models** - Test same prompt across different AI models
 
-## How It Works
+**[Try Playground →](https://prpm.dev/playground)**
 
-```
-┌─────────────────────────────────────┐
-│  prpm install <package> --as cursor │
-└──────────────┬──────────────────────┘
-               │
-               ├─> Fetches from registry
-               ├─> Converts to Cursor format (server-side)
-               ├─> Installs to .cursor/rules/
-               └─> Tracks in prpm.lock
-```
-
-**Smart Features:**
-- **Auto-detection** - Detects Cursor vs Claude vs Continue vs Windsurf
-- **Format conversion** - Server-side conversion to any editor format
-- **Dependency resolution** - Handles package dependencies automatically
-- **Version locking** - prpm-lock.json for consistent installs
-- **Collections** - Install multiple packages as bundles
-
-📚 **[Learn More](https://docs.prpm.dev/guides/format-conversion)**
-
----
-
-## What Makes PRPM Different?
-
-| Feature | PRPM | Manual Copying | Other Tools |
-|---------|------|----------------|-------------|
-| **Collections (multi-package installs)** | ✅ | ❌ | ❌ |
-| **Universal packages (any editor)** | ✅ | ❌ | ❌ |
-| **Server-side format conversion** | ✅ | ❌ | ❌ |
-| **Auto-updates** | ✅ | ❌ | ⚠️ |
-| **Version control** | ✅ | ❌ | ⚠️ |
-| **Dependency handling** | ✅ | ❌ | ❌ |
-| **Works with Cursor + Claude + Continue + Windsurf** | ✅ | ⚠️ | ❌ |
-| **Configures MCP servers (Claude Code)** | ✅ | ❌ | ❌ |
-
----
-
-## 📚 Package Library (2,100+)
-
-- **🎯 Cursor Rules** - Next.js, React, Vue, Python, Laravel, TypeScript, mobile, testing, and hundreds more
-- **🤖 Claude Skills & Agents** - Repository analysis, code review, architecture, specialized workflows
-- **🌊 Windsurf Rules** - Frontend, backend, mobile, DevOps, and full-stack development
-- **🔌 MCP Server Configs** - Auto-configure MCP servers for Claude Code
-- **📦 Collections** - Multi-package bundles for complete workflow setups
-
-**Categories:** Frontend frameworks, Backend frameworks, Programming languages, Testing, Mobile development, Cloud & DevOps, AI & ML, Databases, Web3, Best practices, and more
-
-🌐 **[Browse Packages](https://prpm.dev/search)** | 📚 **[Documentation](https://docs.prpm.dev)**
-
----
-
-## Configuration
-
-PRPM stores configuration in `~/.prpmrc`:
-
-```json
-{
-  "registryUrl": "https://registry.prpm.dev",
-  "token": "your-auth-token",
-  "username": "your-username",
-  "defaultFormat": "cursor",
-  "telemetryEnabled": true
-}
-```
-
-### Set Default Format
-
-```bash
-# Set default format for all installs
-prpm config set defaultFormat cursor  # or claude, continue, windsurf
-```
-
-### Environment Variables
-
-- `PRPM_REGISTRY_URL` - Override registry URL
-- `PRPM_NO_TELEMETRY` - Disable telemetry (set to "1" or "true")
-
-📚 **[Configuration Guide](https://docs.prpm.dev/installation#configuration)**
-
----
-
-## Project Structure
-
-After installing packages, your project will look like:
-
-```
-my-project/
-├── .cursor/rules/          # Cursor rules
-│   └── react-rules.md
-├── .claude/agents/         # Claude agents
-│   └── typescript-best.md
-├── .continue/              # Continue configs
-├── .windsurf/              # Windsurf configs
-├── .promptpm.json          # Package registry
-└── prpm-lock.json          # Lock file
-```
-
----
-
-## Publishing Your Own Package
+## Why PRPM?
 
+### The Problem
 ```bash
-# 1. Create package files
-prpm init  # Creates prpm.json
-
-# 2. Login to registry
-prpm login
-
-# 3. Test package
-prpm publish --dry-run
-
-# 4. Publish
-prpm publish
+# Current workflow (painful)
+1. Find cursor rule on GitHub
+2. Copy raw file URL
+3. Create .cursor/rules/something.md
+4. Paste content
+5. Repeat for every rule
+6. Update manually when rules change
+7. Do it all again for Claude/Continue/Windsurf
 ```
 
-### Example `prpm.json`
-
-```json
-{
-  "name": "my-package",
-  "version": "1.0.0",
-  "description": "My awesome package",
-  "type": "cursor",
-  "format": "cursor",
-  "tags": ["react", "javascript"],
-  "files": [
-    "prpm.json",
-    ".cursorrules",
-    "README.md"
-  ]
-}
-```
+### Team Consistency
 
-Contact [@khaliqgant](https://github.com/khaliqgant) for publishing access.
+If you're working on a big project and some coworkers use Copilot, others use Claude, and sometimes it's Cursor, the only way to unify rules so it's consistent across the codebase is to use PRPM. It's an easy way to make sure everyone has the same rules across the team.
 
-📚 **[Publishing Guide](https://docs.prpm.dev/guides/publishing)**
+## For Package Authors
 
----
+### Share Your Packages
 
-## Supported Formats
+Package authors can publish to PRPM and reach users across all editors.
 
-PRPM supports multiple AI coding assistant formats:
+**How it works:**
+- Authors publish in canonical format
+- PRPM converts to all editor formats automatically
+- Users install in their preferred editor
 
-| Format | Directory | Description |
-|--------|-----------|-------------|
-| `cursor` | `.cursor/rules/` | Cursor IDE rules |
-| `claude` | `.claude/agents/` | Claude sub-agents |
-| `continue` | `.continue/` | Continue extension configs |
-| `windsurf` | `.windsurf/` | Windsurf IDE configs |
-| `copilot` | `.github/instructions/` | GitHub Copilot instructions |
-| `kiro` | `.kiro/steering/` | Kiro steering files |
+**Benefits:**
+- At least 4x reach (Cursor + Claude + Continue + Windsurf users, + more)
+- One package, works everywhere
+- Version control and updates
+- Download analytics
 
 ---
 
 ## Stats
 
-- **2,100+ packages** - Cursor rules, Claude skills/agents, Windsurf rules, MCP configs
-- **Universal package manager** - Works with Cursor, Claude, Continue, Windsurf
+- **7,500+ packages** - Cursor rules, Claude skills/agents, Windsurf rules, MCP configs
+- **Universal package manager** - Works with Cursor, Claude, Continue, Windsurf and more
 - **100+ Collections** - Complete workflow setups in one command
-- **6 editor formats** supported (server-side conversion)
-
----
-
-## Documentation
-
-### 📚 Official Documentation
-
-**➡️ [docs.prpm.dev](https://docs.prpm.dev) - Complete documentation**
-
-**Quick Links:**
-- 🚀 [Getting Started](https://docs.prpm.dev/installation) - Install and configure PRPM
-- 💻 [CLI Reference](https://docs.prpm.dev/cli/commands) - All commands and options
-- 📦 [Collections Guide](https://docs.prpm.dev/concepts/collections) - Multi-package bundles
-- 🔄 [Format Conversion](https://docs.prpm.dev/concepts/formats) - Universal packages explained
-- 🔌 [MCP Servers](https://docs.prpm.dev/guides/mcp-servers) - Model Context Protocol configuration
-
----
-
-## Support & Resources
-
-- **Website**: https://prpm.dev
-- **GitHub**: https://github.com/pr-pm/prpm
-- **Issues**: https://github.com/pr-pm/prpm/issues
-- **Documentation**: https://docs.prpm.dev
+- **6+ editor formats** supported (server-side conversion)
 
----
 
 ## Contributing
 
 We welcome contributions!
 
-- 📦 **Add packages** - Submit your prompts (they'll work in all editors!)
-- 🎁 **Create collections** - Curate helpful package bundles
-- 🐛 **Report bugs** - Open issues
-- 💡 **Suggest features** - Start discussions
-- 🧪 **Write tests** - Improve coverage
+-  **Add packages** - Submit your prompts (they'll work in all editors!)
+-  **Create collections** - Curate helpful package bundles
+-  **Report bugs** - Open issues
+-  **Suggest features** - Start discussions
+-  **Write tests** - Improve coverage
 
-**[Contributing Guide →](https://github.com/pr-pm/prpm/blob/main/CONTRIBUTING.md)**
+**[Contributing Guide →](CONTRIBUTING.md)**
 
 ---
 
 ## License
 
-MIT License - See [LICENSE](https://github.com/pr-pm/prpm/blob/main/LICENSE)
-
----
-
-<div align="center">
-
-**Stop copy-pasting. Start installing.**
-
-**[Read the Docs](https://docs.prpm.dev)** | **[Browse Packages](https://prpm.dev)** | **[Get Started](#installation)**
-
-_Collections install multiple curated packages with one command • Packages work in all editors • No manual copying needed_
-
-Made with 🔥 by [@khaliqgant](https://github.com/khaliqgant)
-
-</div>
+MIT License - See [LICENSE](LICENSE)