npm - prpm - Versions diffs - 0.1.13 → 0.1.15 - Mend

prpm 0.1.13 → 0.1.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/README.md +222 -722
package/dist/commands/playground.js +9 -10
package/dist/core/registry-client.js +7 -0
package/package.json +3 -3

package/README.md CHANGED Viewed

@@ -1,662 +1,261 @@
-# PRPM CLI - Prompt Package Manager
+# PRPM - The Package Manager for AI Prompts
-A comprehensive CLI tool for managing AI prompt packages across multiple platforms (Cursor, Claude, Continue, Windsurf).
+**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.
-## Installation
-### NPM (Recommended)
 ```bash
 npm install -g prpm
+prpm install collection/nextjs-pro  # Entire Next.js setup in one command
 ```
-### Homebrew (macOS)
-```bash
-# Direct installation (recommended)
-brew install khaliqgant/homebrew-prpm/prpm
-# Or manual tap installation
-brew tap khaliqgant/homebrew-prpm
-brew install prpm
-```
-### Direct Download
-Download the latest binary from [GitHub Releases](https://github.com/pr-pm/prpm/releases).
-## Quick Start
-```bash
-# Search for packages
-prpm search react
-# Install a package from the registry
-prpm install @username/react-rules
-# Add a package from a URL
-prpm add https://raw.githubusercontent.com/user/repo/main/rules.md --as cursor
+**2,100+ packages** | **Works everywhere** (Cursor, Claude, Continue, Windsurf, GitHub Copilot, Kiro) | **One command to install**
-# List installed packages
-prpm list
+📚 **[Official Documentation](https://docs.prpm.dev)** | 🌐 **[Browse Packages](https://prpm.dev)**
-# Check for updates
-prpm outdated
-```
-## Commands
-### Package Management
+---
-#### `prpm install <package>`
+## 📦 Collections - Complete Setups in One Command
-Install a package from the PRPM registry.
+Skip installing packages one-by-one. Get curated bundles for your entire workflow:
 ```bash
-# Install latest version
-prpm install @username/react-rules
+# Install 5+ packages at once
+prpm install collection/nextjs-pro
+# → Installs react-best-practices, typescript-strict, tailwind-helper,
+#    nextjs-patterns, component-architect
-# Install specific version
-prpm install @username/react-rules@1.2.0
+# Python data science stack
+prpm install collection/python-data
+# → Installs pandas-helper, numpy-patterns, matplotlib-guide,
+#    jupyter-best-practices, ml-workflow
-# Install with custom format
-prpm install @username/react-rules --as claude
-# Install with frozen lockfile (CI mode)
-prpm install @username/react-rules --frozen-lockfile
+# Full-stack React
+prpm install collection/react-fullstack
+# → Everything for React + Node + PostgreSQL (8 packages)
 ```
-**Options:**
-- `--version <version>` - Specific version to install
-- `--type <type>` - Override package type (cursor, claude, continue, windsurf, generic)
-- `--as <format>` - Download in specific format (cursor, claude, continue, windsurf, canonical)
-- `--frozen-lockfile` - Fail if lock file needs to be updated (for CI)
-**Examples:**
-```bash
-# Install for Claude
-prpm install @username/typescript-rules --as claude
-# Install specific version
-prpm install @username/typescript-rules --version 2.1.0
-# CI mode with frozen lockfile
-prpm install @username/typescript-rules --frozen-lockfile
-```
+**[Browse Collections →](https://prpm.dev/search?tab=collections)**
 ---
-#### `prpm add <url>`
+## 🔄 Universal Packages - Install Once, Use Anywhere
-Add a package directly from a raw GitHub URL.
+Every package works in **any** AI editor. No conversion tools, no separate downloads:
 ```bash
-# Add a Cursor rule
-prpm add https://raw.githubusercontent.com/user/repo/main/rules.md --as cursor
+# 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/
-# Add a Claude agent
-prpm add https://raw.githubusercontent.com/user/repo/main/agent.md --as claude
+# Or just let PRPM auto-detect
+prpm install @username/react-best-practices  # Installs in the right place automatically
 ```
-**Options:**
-- `--as <type>` - Package type (cursor or claude), default: cursor
-**Examples:**
-```bash
-# Add from GitHub
-prpm add https://raw.githubusercontent.com/acme/rules/main/cursor-rules.md --as cursor
-# Add from custom URL
-prpm add https://example.com/my-rules.md --as claude
-```
+**Format conversion happens server-side.** Authors publish once, users install everywhere.
 ---
-#### `prpm uninstall <id>`
-Remove an installed package.
+## Why PRPM?
+### The Problem
 ```bash
-prpm uninstall react-rules
+# 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
 ```
-**Examples:**
+### The Solution
 ```bash
-# Remove by package ID
-prpm uninstall typescript-rules
-# Remove cursor rules
-prpm uninstall cursor-rules
+# 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
 ```
----
-#### `prpm list`
-List all installed packages.
-```bash
-prpm list
-```
+**It's npm for AI prompts. But it works everywhere.**
-Displays a formatted table showing:
-- Package ID
-- Package type
-- Source URL
-- Installation path
+### Team Consistency
-**Example output:**
-```
-ID              TYPE    URL                                          DESTINATION
-react-rules     cursor  https://registry.prpm.dev/...            .cursor/rules/react-rules.md
-typescript-best claude  https://registry.prpm.dev/...            .claude/agents/typescript-best.md
-Total: 2 packages
-```
+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.
 ---
-#### `prpm index`
-Scan existing `.cursor/rules/` and `.claude/agents/` directories and register any unregistered files.
+## Installation
 ```bash
-prpm index
-```
-This is useful when:
-- You have existing prompt files in your project
-- You want to import files into PRPM tracking
-- You manually copied files and want them registered
-**Example output:**
-```
-Found 3 files in .cursor/rules/
-  Added: cursor-rules.md (cursor-rules)
-  Skipped: existing-rules.md (already registered)
-Found 1 file in .claude/agents/
-  Added: agent.md (agent)
+# NPM (recommended)
+npm install -g prpm
-Summary: 2 new packages added, 1 already registered
+# Homebrew (macOS)
+brew install khaliqgant/homebrew-prpm/prpm
 ```
 ---
-### Discovery & Search
-#### `prpm search <query>`
-Search for packages in the registry.
+## Quick Start
 ```bash
-# Basic search
-prpm search react
-# Filter by type
-prpm search typescript --type cursor
-# Limit results
-prpm search coding --limit 10
-```
-**Options:**
-- `--type <type>` - Filter by package type (cursor, claude, continue, windsurf, generic)
-- `--limit <number>` - Number of results to show (default: 20)
+# Install a complete collection
+prpm install collection/nextjs-pro
-**Examples:**
-```bash
-# Search for React-related packages
+# Or browse and search
 prpm search react
-# Find Cursor-specific packages
-prpm search javascript --type cursor
-# Get top 5 results
-prpm search best-practices --limit 5
-```
----
-#### `prpm trending`
-Show trending packages from the last 7 days.
-```bash
-# Show trending packages
 prpm trending
+prpm collections
-# Filter by type
-prpm trending --type cursor
-# Show more results
-prpm trending --limit 20
-```
-**Options:**
-- `--type <type>` - Filter by package type (cursor, claude, continue, windsurf, generic)
-- `--limit <number>` - Number of packages to show (default: 10)
-**Examples:**
-```bash
-# Top 10 trending packages
-prpm trending
-# Trending Claude packages
-prpm trending --type claude
-# Top 5 trending
-prpm trending --limit 5
-```
----
-#### `prpm popular`
-Show all-time popular packages.
-```bash
-# Show popular packages
-prpm popular
-# Filter by type
-prpm popular --type cursor
-```
-**Options:**
-- `-t, --type <type>` - Filter by package type (cursor, claude, continue, windsurf)
+# Install individual packages
+prpm install @username/test-driven-development
+prpm install @username/react-best-practices --as cursor
-**Examples:**
-```bash
-# Most popular packages
-prpm popular
+# Check what's installed
+prpm list
-# Popular Cursor packages
-prpm popular --type cursor
+# Keep packages up to date
+prpm outdated
+prpm update
 ```
 ---
-#### `prpm info <package>`
-Display detailed information about a package.
-```bash
-prpm info @username/react-rules
-```
-Shows:
-- Package name and description
-- Download statistics
-- Rating
-- Latest version
-- Tags and categories
-- Installation instructions
-**Example output:**
-```
-React Development Rules ✓ Verified
-A comprehensive set of React best practices and rules.
-Stats:
-   Downloads: 12,543
-   Rating: ★★★★★ (4.8/5)
-Latest Version: 2.1.0
-Tags: react, javascript, best-practices
-Installation:
-   prpm install @username/react-rules
-   prpm install @username/react-rules@2.1.0
-```
----
+## Commands
 ### Collections
-#### `prpm collections` / `prpm collections list`
-List available package collections.
 ```bash
-# List all collections
-prpm collections
-# Filter by category
-prpm collections list --category frontend
-# Show only official collections
-prpm collections list --official
-# Filter by scope
-prpm collections list --scope prpm
+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
 ```
-**Options:**
-- `--category <category>` - Filter by category
-- `--tag <tag>` - Filter by tag
-- `--official` - Show only official collections
-- `--scope <scope>` - Filter by scope
-**Examples:**
-```bash
-# View all collections
-prpm collections
-# Official collections only
-prpm collections list --official
-# Frontend-related collections
-prpm collections list --category frontend
-```
----
-#### `prpm collections info <collection>`
-Show detailed information about a collection.
+### Package Management
 ```bash
-# View collection details
-prpm collections info @prpm/react-starter
-# View specific version
-prpm collections info @prpm/react-starter@1.0.0
-```
-Shows:
-- Collection description
-- Statistics (downloads, stars)
-- Included packages (required and optional)
-- Installation instructions
-**Example output:**
-```
-React Starter Kit
-==================
-A curated collection of React development packages.
-Stats:
-   Downloads: 5,432
-   Stars: 234
-   Version: 1.0.0
-   Packages: 5
-Included Packages:
-   Required:
-   1. ✓ react-rules@2.1.0
-      Best practices for React development
-   Optional:
-   1. ○ typescript-rules@1.0.0
-      TypeScript configuration for React
-Install:
-   prpm install @prpm/react-starter
+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
 ```
----
-### Updates & Upgrades
-#### `prpm outdated`
-Check for package updates.
+### Discovery
 ```bash
-prpm outdated
-```
-Shows which packages have updates available, grouped by:
-- Major updates (breaking changes possible)
-- Minor updates (new features)
-- Patch updates (bug fixes)
-**Example output:**
-```
-Major Updates (breaking changes possible):
-   react-rules                    1.0.0 → 2.0.0
-Minor Updates (new features):
-   typescript-rules               1.0.0 → 1.1.0
-Patch Updates (bug fixes):
-   eslint-config                  1.0.0 → 1.0.1
-Run "prpm update" to update to latest minor/patch versions
-Run "prpm upgrade" to upgrade to latest major versions
+prpm trending                        # Trending packages
+prpm popular                         # Most popular packages
+prpm info <package-name>             # Package details
 ```
----
-#### `prpm update [package]`
-Update packages to latest compatible versions (minor/patch only, skips major versions).
+### Updates
 ```bash
-# Update all packages
-prpm update
-# Update specific package
-prpm update react-rules
+prpm outdated                        # Check for updates
+prpm update                          # Update all packages
+prpm upgrade                         # Upgrade (including major versions)
 ```
-**Options:**
-- `--all` - Update all packages
-**Examples:**
+### Publishing
 ```bash
-# Update all packages (safe updates only)
-prpm update
-# Update specific package
-prpm update typescript-rules
+prpm login                           # Login to registry
+prpm whoami                          # Show current user
+prpm publish                         # Publish a package
+prpm init                            # Create prpm.json
 ```
----
-#### `prpm upgrade [package]`
-Upgrade packages to latest versions (including major updates).
+### Configuration
 ```bash
-# Upgrade all packages
-prpm upgrade
-# Upgrade specific package
-prpm upgrade react-rules
-# Skip warning for major updates
-prpm upgrade --force
+prpm config set defaultFormat cursor # Set default format
+prpm config get defaultFormat        # Get config value
+prpm config list                     # List all config
 ```
-**Options:**
-- `--all` - Upgrade all packages
-- `--force` - Skip warning for major version upgrades
-**Examples:**
-```bash
-# Upgrade all (including major versions)
-prpm upgrade
-# Upgrade specific package
-prpm upgrade react-rules
-# Force upgrade without warnings
-prpm upgrade --force
-```
+📚 **[Full CLI Reference](https://docs.prpm.dev/cli/commands)** | **[All Documentation](https://docs.prpm.dev)**
 ---
-### Dependencies
-#### `prpm deps <package>`
-Show dependency tree for a package.
+## Real-World Examples
+### Complete Next.js Setup
 ```bash
-# View dependencies
-prpm deps react-rules
-# View dependencies for specific version
-prpm deps react-rules@1.2.0
-```
-Shows:
-- Resolved dependency versions
-- Dependency tree structure
-- Total dependency count
-**Example output:**
-```
-Resolving dependencies for react-rules@1.2.0...
-Resolved Dependencies:
-   eslint-config@2.0.0
-   typescript-rules@1.1.0
-Total: 2 dependencies
-Dependency Tree:
-└─ react-rules@1.2.0
-   ├─ eslint-config@2.0.0
-   └─ typescript-rules@1.1.0
+prpm install collection/nextjs-pro
+# Installs 5+ packages in one command: React best practices, TypeScript config,
+# Tailwind helpers, Next.js patterns, component architecture
 ```
----
-### Authentication & Publishing
-#### `prpm login`
-Login to the PRPM registry.
+### Switch Between Editors
 ```bash
-# OAuth login (opens browser)
-prpm login
+# Working in Cursor today
+prpm install @username/react-best-practices --as cursor
-# Login with token
-prpm login --token YOUR_TOKEN
+# Trying Claude Code tomorrow
+prpm install @username/react-best-practices --as claude
+# Same package, different format. Zero conversion work.
 ```
-**Options:**
-- `--token <token>` - Login with a personal access token
-**Login Flow:**
-1. Opens browser for GitHub authentication
-2. Authorize the application
-3. Token is automatically saved
-4. Ready to publish packages
-**Examples:**
+### Get Code Reviews
 ```bash
-# Interactive OAuth login
-prpm login
-# Manual token login
-prpm login --token ghp_xxxxxxxxxxxx
+prpm install @username/karen-skill
+# Ask in Claude Code: "Karen, review this repository"
+# Get: 78/100 score + market research + actionable fixes
 ```
 ---
-#### `prpm whoami`
+## How It Works
-Show current logged-in user.
-```bash
-prpm whoami
-```
-**Example output:**
 ```
-username
+┌─────────────────────────────────────┐
+│  prpm install <package> --as cursor │
+└──────────────┬──────────────────────┘
+               │
+               ├─> Fetches from registry
+               ├─> Converts to Cursor format (server-side)
+               ├─> Installs to .cursor/rules/
+               └─> Tracks in prpm.lock
 ```
-If not logged in:
-```
-Not logged in
+**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
-Run "prpm login" to authenticate
-```
+📚 **[Learn More](https://docs.prpm.dev/guides/format-conversion)**
 ---
-#### `prpm publish`
+## What Makes PRPM Different?
-Publish a package to the registry.
-```bash
-# Publish package
-prpm publish
-# Dry run (validate without publishing)
-prpm publish --dry-run
-# Publish with tag
-prpm publish --tag beta
-```
-**Options:**
-- `--access <type>` - Package access (public or private), default: public
-- `--tag <tag>` - NPM-style tag (e.g., latest, beta), default: latest
-- `--dry-run` - Validate package without publishing
-**Requirements:**
-- Must be logged in (`prpm login`)
-- Must have `prpm.json` manifest in current directory
-- Package files must exist
-**prpm.json format:**
-```json
-{
-  "name": "my-package",
-  "version": "1.0.0",
-  "description": "My awesome package",
-  "type": "cursor",
-  "tags": ["react", "javascript"],
-  "files": [
-    "prpm.json",
-    ".cursorrules",
-    "README.md"
-  ]
-}
-```
-**Examples:**
-```bash
-# Publish to registry
-prpm publish
-# Test before publishing
-prpm publish --dry-run
-# Publish beta version
-prpm publish --tag beta
-```
+| 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)** | ✅ | ❌ | ❌ |
 ---
-### Telemetry
-#### `prpm telemetry enable`
-Enable anonymous usage analytics.
-```bash
-prpm telemetry enable
-```
-Helps improve PRPM by collecting anonymous usage data via PostHog.
----
+## 📚 Package Library (2,100+)
-#### `prpm telemetry disable`
+- **🎯 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
-Disable telemetry and analytics.
+**Categories:** Frontend frameworks, Backend frameworks, Programming languages, Testing, Mobile development, Cloud & DevOps, AI & ML, Databases, Web3, Best practices, and more
-```bash
-prpm telemetry disable
-```
+🌐 **[Browse Packages](https://prpm.dev/search)** | 📚 **[Documentation](https://docs.prpm.dev)**
 ---
@@ -674,19 +273,22 @@ PRPM stores configuration in `~/.prpmrc`:
 }
 ```
-### Configuration Options
+### Set Default Format
-- `registryUrl` - Registry server URL
-- `token` - Authentication token (set via `prpm login`)
-- `username` - Logged-in username
-- `defaultFormat` - Default package format (cursor, claude, continue, windsurf)
-- `telemetryEnabled` - Enable/disable usage analytics
+```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:
@@ -703,96 +305,13 @@ my-project/
 └── prpm-lock.json          # Lock file
 ```
-### Package Registry (`.promptpm.json`)
-Tracks installed packages:
-```json
-{
-  "packages": [
-    {
-      "id": "react-rules",
-      "type": "cursor",
-      "url": "https://registry.prpm.dev/packages/react-rules",
-      "dest": ".cursor/rules/react-rules.md",
-      "version": "2.1.0"
-    }
-  ]
-}
-```
-### Lock File (`prpm-lock.json`)
-Ensures consistent installations:
-```json
-{
-  "version": "1.0.0",
-  "packages": {
-    "react-rules": {
-      "version": "2.1.0",
-      "tarballUrl": "https://registry.prpm.dev/...",
-      "integrity": "sha512-...",
-      "type": "cursor",
-      "format": "cursor"
-    }
-  }
-}
-```
-## Common Workflows
-### Starting a New Project
-```bash
-# Initialize with popular packages
-prpm install @prpm/starter-kit
-# Or install individually
-prpm search react
-prpm install @username/react-rules
-prpm install @username/typescript-rules
-```
-### Keeping Packages Updated
-```bash
-# Check for updates
-prpm outdated
-# Update safe changes (minor/patch)
-prpm update
-# Upgrade to latest (including major)
-prpm upgrade
-```
-### Working with Collections
-```bash
-# Browse collections
-prpm collections
-# View collection details
-prpm collections info @prpm/react-starter
-# Install collection
-prpm install @prpm/react-starter
-```
+---
-### Publishing Your Own Package
+## Publishing Your Own Package
 ```bash
-# 1. Create prpm.json
-cat > prpm.json << EOF
-{
-  "name": "my-rules",
-  "version": "1.0.0",
-  "description": "My custom rules",
-  "type": "cursor",
-  "files": ["prpm.json", ".cursorrules", "README.md"]
-}
-EOF
+# 1. Create package files
+prpm init  # Creates prpm.json
 # 2. Login to registry
 prpm login
@@ -804,25 +323,29 @@ prpm publish --dry-run
 prpm publish
 ```
-### Adding Existing Files
+### Example `prpm.json`
-```bash
-# If you already have prompt files
-prpm index
-# Or add specific files
-prpm add ./my-rules.md --as cursor
+```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"
+  ]
+}
 ```
-### CI/CD Integration
+Contact [@khaliqgant](https://github.com/khaliqgant) for publishing access.
-```bash
-# In CI pipeline - use frozen lockfile
-prpm install --frozen-lockfile
+📚 **[Publishing Guide](https://docs.prpm.dev/guides/publishing)**
-# Or install all from lock file
-prpm install
-```
+---
 ## Supported Formats
@@ -834,95 +357,72 @@ PRPM supports multiple AI coding assistant formats:
 | `claude` | `.claude/agents/` | Claude sub-agents |
 | `continue` | `.continue/` | Continue extension configs |
 | `windsurf` | `.windsurf/` | Windsurf IDE configs |
-| `canonical` | N/A | Original format (no conversion) |
-### Format Conversion
-PRPM automatically converts packages between formats:
-```bash
-# Install Cursor package as Claude format
-prpm install @username/cursor-rules --as claude
+| `copilot` | `.github/instructions/` | GitHub Copilot instructions |
+| `kiro` | `.kiro/steering/` | Kiro steering files |
-# Install Claude package as Cursor format
-prpm install @username/claude-agent --as cursor
-```
-## Troubleshooting
-### Command Not Found
+---
-```bash
-# Reinstall globally
-npm install -g prpm
+## Stats
-# Or check PATH
-echo $PATH
-```
+- **2,100+ packages** - Cursor rules, Claude skills/agents, Windsurf rules, MCP configs
+- **Universal package manager** - Works with Cursor, Claude, Continue, Windsurf
+- **100+ Collections** - Complete workflow setups in one command
+- **6 editor formats** supported (server-side conversion)
-### Authentication Issues
+---
-```bash
-# Re-login
-prpm login
+## Documentation
-# Check current user
-prpm whoami
+### 📚 Official Documentation
-# Use token directly
-prpm login --token YOUR_TOKEN
-```
+**➡️ [docs.prpm.dev](https://docs.prpm.dev) - Complete documentation**
-### Installation Failures
+**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
-```bash
-# Check package exists
-prpm search package-name
+---
-# Get package info
-prpm info @username/package-name
+## Support & Resources
-# Try specific version
-prpm install package-name@1.0.0
-```
+- **Website**: https://prpm.dev
+- **GitHub**: https://github.com/pr-pm/prpm
+- **Issues**: https://github.com/pr-pm/prpm/issues
+- **Documentation**: https://docs.prpm.dev
-### Lock File Issues
+---
-```bash
-# Update lock file
-prpm install
+## Contributing
-# In CI, ensure lock file exists
-prpm install --frozen-lockfile
-```
+We welcome contributions!
-### Registry Connection Issues
+- 📦 **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
-```bash
-# Check registry URL
-cat ~/.prpmrc
+**[Contributing Guide →](https://github.com/pr-pm/prpm/blob/main/CONTRIBUTING.md)**
-# Set custom registry
-export PRPM_REGISTRY_URL=https://custom-registry.com
-```
+---
-## Support & Resources
+## License
-- **GitHub**: https://github.com/pr-pm/prpm
-- **Issues**: https://github.com/pr-pm/prpm/issues
-- **Registry**: https://registry.prpm.dev
-- **Documentation**: https://github.com/pr-pm/prpm#readme
+MIT License - See [LICENSE](https://github.com/pr-pm/prpm/blob/main/LICENSE)
-## Contributing
+---
-We welcome contributions! See the main repository for contribution guidelines.
+<div align="center">
-## License
+**Stop copy-pasting. Start installing.**
-MIT License - see LICENSE file for details.
+**[Read the Docs](https://docs.prpm.dev)** | **[Browse Packages](https://prpm.dev)** | **[Get Started](#installation)**
-## Version
+_Collections install multiple curated packages with one command • Packages work in all editors • No manual copying needed_
-Current version: 1.2.0
+Made with 🔥 by [@khaliqgant](https://github.com/khaliqgant)
-Requires Node.js >= 16.0.0
+</div>

package/dist/commands/playground.js CHANGED Viewed

@@ -96,21 +96,20 @@ async function resolvePackageId(packageName) {
     if (uuidRegex.test(packageName)) {
         return packageName;
     }
-    // Search for the package by name
+    // Look up package by name directly
     const config = await (0, user_config_1.getConfig)();
     const baseUrl = (config.registryUrl || "https://registry.prpm.dev").replace(/\/$/, '');
-    const response = await fetch(`${baseUrl}/api/v1/search?q=${encodeURIComponent(packageName)}&limit=10`);
+    // URL encode the package name to handle scoped packages like @user/package
+    const encodedName = encodeURIComponent(packageName);
+    const response = await fetch(`${baseUrl}/api/v1/packages/${encodedName}`);
     if (!response.ok) {
-        throw new Error(`Failed to search for package: ${response.statusText}`);
+        if (response.status === 404) {
+            throw new Error(`Package not found: ${packageName}`);
+        }
+        throw new Error(`Failed to fetch package: ${response.statusText}`);
     }
     const data = await response.json();
-    // Find exact match
-    const exactMatch = data.packages.find(pkg => pkg.name === packageName);
-    if (exactMatch) {
-        return exactMatch.id;
-    }
-    // If no exact match, throw error
-    throw new Error(`Package not found: ${packageName}`);
+    return data.id;
 }
 /**
  * Execute a playground run

package/dist/core/registry-client.js CHANGED Viewed

@@ -3,9 +3,15 @@
  * Registry API Client
  * Handles all communication with the PRMP Registry
  */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RegistryClient = void 0;
 exports.getRegistryClient = getRegistryClient;
+const package_json_1 = __importDefault(require("../../package.json"));
+// CLI version for User-Agent header (exempts from rate limiting)
+const CLI_VERSION = package_json_1.default.version;
 class RegistryClient {
     constructor(config) {
         this.baseUrl = config.url.replace(/\/$/, ''); // Remove trailing slash
@@ -217,6 +223,7 @@ class RegistryClient {
         }
         const headers = {
             'Content-Type': 'application/json',
+            'User-Agent': `prpm-cli/${CLI_VERSION}`,
             ...options.headers,
         };
         if (this.token) {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "prpm",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Prompt Package Manager CLI - Install and manage prompt-based files",
   "main": "dist/index.js",
   "bin": {
@@ -45,8 +45,8 @@
   "license": "MIT",
   "dependencies": {
     "@octokit/rest": "^22.0.0",
-    "@pr-pm/registry-client": "^1.3.11",
-    "@pr-pm/types": "^0.2.12",
+    "@pr-pm/registry-client": "^1.3.13",
+    "@pr-pm/types": "^0.2.14",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "commander": "^11.1.0",