🎨 Prompt Registry

A visual marketplace for discovering, installing, and managing GitHub Copilot prompt libraries from multiple sources.

📋 Table of Contents

Overview
Features
Installation
Quick Start
Usage
Supported Sources
Architecture
Configuration
Troubleshooting
Contributing
License

🌟 Overview

Prompt Registry transforms how you discover and manage GitHub Copilot prompts. Instead of manually copying prompt files or cloning repositories, browse a visual marketplace, search by tags, and install curated prompt libraries with a single click.

Prompty Registry - main views

Why Prompt Registry?

🎯 Discover - Browse curated prompt collections from multiple sources
⚡ Install - One-click installation with automatic Copilot sync
🔄 Manage - Update, organize, and uninstall bundles easily
👥 Share - Create and distribute your own prompt libraries
🌍 Multi-Platform - Works on macOS, Linux, and Windows

✨ Features

🎨 Visual Marketplace

Browse prompt bundles in a modern, tile-based interface inspired by VS Code's extension marketplace:

Rich Metadata: See descriptions, tags, content breakdown, and installation status
Search & Filter: Find prompts by keywords, tags, or content type
Content Preview: View detailed information before installing
One-Click Install: Install bundles instantly from the marketplace

🔌 Multi-Source Support

Connect to various prompt sources:

Source Type	Description	Use Case
Awesome Copilot	Curated community collections	Discover popular prompts
GitHub	Direct from GitHub repositories	Team/project-specific prompts
GitLab	GitLab repositories and releases	Enterprise GitLab users
HTTP	Any HTTP/HTTPS URL	Custom hosting
Local	File system directories	Private/offline prompts

📦 Bundle Management

Install/Uninstall: Manage bundles through UI or commands
Version Control: Track installed versions
Auto-Sync: Automatic synchronization with GitHub Copilot
Conflict Resolution: Handle duplicate bundles gracefully

👥 Profile Management

Organize prompts by project, team, or environment:

Work Projects Profile
  ├── testing-automation (v1.0.0)
  ├── code-review (v2.1.0)
  └── api-documentation (v1.5.0)

Personal Profile
  ├── creative-writing (v1.0.0)
  └── learning-resources (v0.9.0)

🌍 Cross-Platform

Automatically detects and uses the correct directories:

macOS: ~/Library/Application Support/Code/User/prompts
Linux: ~/.config/Code/User/prompts
Windows: %APPDATA%/Code/User/prompts

Supports all VS Code flavors: Stable, Insiders, and Windsurf.

📦 Installation

From VS Code Marketplace

Open VS Code
Press Ctrl+Shift+X (or Cmd+Shift+X on macOS)
Search for "Prompt Registry"
Click Install

From VSIX

# Download the latest .vsix file
code --install-extension prompt-registry-2.0.0.vsix

From Source

git clone https://github.com/AmadeusITGroup/prompt-registry.git
cd prompt-registry
npm install
npm run compile
code --install-extension .

🚀 Quick Start

1. Add a Source

First, add a prompt source to the registry:

Ctrl+Shift+P → "Prompt Registry: Add Source"

Choose a source type:

Awesome Copilot Collection - Pre-configured curated prompts
GitHub Repository - Enter repository URL
Local Directory - Select a folder

2. Browse the Marketplace

Open the Prompt Registry Marketplace:

Click "MARKETPLACE" in the Prompt Registry sidebar

Or use the command:

Ctrl+Shift+P → "Prompt Registry: Open Marketplace"

3. Install a Bundle

Click on any bundle tile to view details, then click Install.

Your prompts are now available in GitHub Copilot! 🎉

📖 Usage

Browsing the Marketplace

The marketplace provides multiple ways to discover prompts:

Search

Type in the search box to filter by:
- Bundle name
- Description keywords
- Tags

Filter by Content Type

Click filter buttons to show only:
- Prompts
- Instructions
- Chat Modes
- Agents

View Details

Click on any bundle tile to see:
- Full description
- Content breakdown (prompts, instructions, etc.)
- Installation information
- Tags and metadata
- List of included files

Installing Bundles

From Marketplace

Browse - Find a bundle in the marketplace
Review - Click the tile to view details
Install - Click the Install button
Verify - Check the installed badge appears

From Tree View

Navigate - Go to Registry Explorer in sidebar
Find - Locate a bundle under a source
Install - Right-click → "Install Bundle"

From Command Palette

Ctrl+Shift+P → "Prompt Registry: Install Bundle"
# Select source → Select bundle → Confirm

Managing Sources

Add Source

Ctrl+Shift+P → "Prompt Registry: Add Source"

Awesome Copilot Collection (Recommended for beginners):

Pre-configured
Curated community prompts
Automatically updated

GitHub Repository:

Repository URL: https://github.com/owner/repo
Branch: main (optional)
Collections Path: collections (optional)

Local Directory:

Select a folder containing deployment-manifest.yml

Edit Source

Right-click source in tree view → "Edit Source"

Remove Source

Right-click source in tree view → "Remove Source"

Working with Profiles

Profiles help organize bundles by project, team, or environment.

Create Profile

Ctrl+Shift+P → "Prompt Registry: Create Profile"
# Enter profile name (e.g., "Work Projects")

Install to Profile

When installing a bundle:
1. Choose "Profile" scope
2. Select target profile
3. Bundle installs only to that profile

Switch Profile

Ctrl+Shift+P → "Prompt Registry: Switch Profile"
# Select active profile

View Profile Contents

Sidebar → "My Profiles" → Select profile
# See all bundles in that profile

🔌 Supported Sources

Awesome Copilot Collection

Pre-configured curated source for community prompts.

Type: awesome-copilot
URL: https://github.com/microsoft/prompt-bundle-spec
Collections Path: examples

Features:

✅ Community-curated collections
✅ Well-tested prompts
✅ Regular updates
✅ Wide variety of use cases

GitHub Repository

Any GitHub repository with collections.

Type: github
URL: https://github.com/owner/repo
Branch: main
Collections Path: prompts/collections

Requirements:

Repository must be public (or provide authentication)
Collections directory with .collection.yml files
Each collection references prompt files

GitLab Repository

GitLab repositories and releases.

Type: gitlab
URL: https://gitlab.com/owner/repo
Branch: main

HTTP/HTTPS Source

Any web-accessible ZIP bundles.

Type: http
URL: https://example.com/bundles/

Bundles must:

Be ZIP files
Contain deployment-manifest.yml
Be accessible via HTTPS (recommended)

Local Directory

File system directories.

Type: local
Path: /path/to/prompts

Useful for:

Private prompt libraries
Offline development
Testing custom bundles

🏗️ Architecture

High-Level Overview

graph TB
    subgraph "User Interface"
        MV[Marketplace View]
        TV[Tree View]
    end
    
    subgraph "Core Services"
        RM[Registry Manager]
        BI[Bundle Installer]
        CS[Copilot Sync]
    end
    
    subgraph "Adapters"
        ACA[Awesome Copilot]
        GHA[GitHub]
        GLA[GitLab]
        HTA[HTTP]
        LCA[Local]
    end
    
    MV --> RM
    TV --> RM
    RM --> BI
    BI --> CS
    RM --> ACA
    RM --> GHA
    RM --> GLA
    RM --> HTA
    RM --> LCA
    
    style RM fill:#4CAF50
    style BI fill:#2196F3
    style CS fill:#FF9800

For detailed architecture, see ARCHITECTURE.md

Key Components

Registry Manager: Orchestrates sources, bundles, and installations
Bundle Installer: Handles extraction, validation, and installation
Copilot Sync: Syncs bundles to GitHub Copilot directories
Adapters: Source-specific implementations (GitHub, GitLab, etc.)
UI Providers: Marketplace and tree view interfaces

Installation Flow

sequenceDiagram
    participant User
    participant Marketplace
    participant Adapter
    participant Installer
    participant Copilot
    
    User->>Marketplace: Click Install
    Marketplace->>Adapter: Download bundle
    Adapter-->>Installer: ZIP archive
    Installer->>Installer: Extract & validate
    Installer->>Copilot: Sync prompts
    Copilot-->>User: Ready to use

⚙️ Configuration

Extension Settings

Access via File → Preferences → Settings → Extensions → Prompt Registry

Setting	Description	Default
`promptRegistry.autoSync`	Auto-sync to Copilot on install	`true`
`promptRegistry.cacheTimeout`	Bundle cache TTL (minutes)	`5`
`promptRegistry.defaultScope`	Default installation scope	`user`
`promptRegistry.showNotifications`	Show success notifications	`true`

Source Configuration

Sources are stored in ~/.vscode/extensions/.../registry.json:

{
  "sources": [
    {
      "id": "awesome-copilot",
      "name": "Awesome Copilot Collection",
      "type": "awesome-copilot",
      "url": "https://github.com/microsoft/prompt-bundle-spec",
      "enabled": true
    }
  ]
}

Bundle Manifest

Bundles must include deployment-manifest.yml:

version: "1.0"
id: "testing-automation"
name: "Testing & Test Automation"
version: "1.0.0"
description: "Comprehensive prompts for testing"
author: "github"
tags:
  - testing
  - automation
  - qa

prompts:
  - id: "unit-tests"
    name: "Unit Test Generator"
    type: "prompt"
    file: "prompts/unit-tests.prompt.md"
    tags:
      - unit-testing
      - tdd

🔧 Troubleshooting

Common Issues

Bundles Not Showing in Copilot

Problem: Installed bundles don't appear in GitHub Copilot.

Solution:

Check sync completed: View extension logs
Verify directory: Check OS-specific path exists
Restart VS Code: Reload window (Ctrl+R)
Manual sync: Run "Prompt Registry: Sync All Bundles"

Installation Fails

Problem: "Failed to install bundle" error.

Solutions:

Network Error: Check internet connection
Permission Error: Ensure write access to user directory
Invalid Bundle: Verify bundle has valid manifest
Disk Space: Check available storage

Source Connection Failed

Problem: Cannot fetch bundles from source.

Solutions:

GitHub: Check repository URL and visibility
Authentication: Add access token if needed
Network: Verify HTTPS access not blocked
Rate Limiting: Wait before retrying

Wrong Installation Path (macOS)

Problem: Prompts install to ~/.config/Code instead of ~/Library/Application Support/Code.

Solution: Update to latest version (2.0.0+) with proper macOS support.

Debug Mode

Enable debug logging:

{
  "promptRegistry.debug": true
}

View logs in Output panel: View → Output → Prompt Registry

Getting Help

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Development Setup

# Clone repository
git clone https://github.com/AmadeusITGroup/prompt-registry.git
cd prompt-registry

# Install dependencies
npm install

# Compile
npm run compile

# Watch mode (auto-compile)
npm run watch

# Run tests
npm test

# Package extension
vsce package

Creating a New Adapter

See ARCHITECTURE.md#extension-points for details on implementing custom adapters.

Project Structure

prompt-registry/
├── src/
│   ├── adapters/          # Source adapters
│   ├── commands/          # Command implementations
│   ├── services/          # Core services
│   ├── ui/               # UI providers
│   ├── types/            # TypeScript types
│   └── utils/            # Utilities
├── docs/                  # Documentation
├── test/                  # Test suites
└── package.json          # Extension manifest

📚 Documentation

Architecture Guide - Detailed system architecture
API Reference - Extension API documentation
Bundle Format - Creating custom bundles
Adapter Development - Building new adapters
Awesome Copilot Implementation - Awesome Copilot adapter details

🗺️ Roadmap

Current Version (2.0.0)

✅ Visual marketplace interface
✅ Multi-source support (5 adapter types)
✅ Profile management
✅ Cross-platform support (macOS, Linux, Windows)
✅ Auto-sync with GitHub Copilot
✅ Search and filtering
✅ Clickable marketplace tiles

Upcoming (2.1.0)

🔄 Automatic bundle updates
🔄 Bundle versioning and rollback
🔄 Dependency management
🔄 Bundle analytics

Future (3.0.0)

📋 Bundle authoring tools
📋 Community ratings and reviews
📋 AI-powered recommendations
📋 Collaborative prompt sharing
📋 Marketplace API for third-party tools

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

🙏 Acknowledgments

Microsoft - For GitHub Copilot and VS Code
Awesome Copilot Community - For curated prompt collections
Contributors - Everyone who has contributed to this project

📊 Stats

Supported Source Types: 5 (GitHub, GitLab, HTTP, Local, Awesome Copilot)
Platforms: macOS, Linux, Windows
VS Code Flavors: Stable, Insiders, Windsurf
Architecture: Adapter pattern with extensible design
Bundle Format: YAML-based deployment manifest

🔗 Links

Homepage: https://prompt-registry.dev
Documentation: https://docs.prompt-registry.dev
GitHub: https://github.com/AmadeusITGroup/prompt-registry
Issues: https://github.com/AmadeusITGroup/prompt-registry/issues
Marketplace: VS Code Marketplace

Made with ❤️ by the Prompt Registry Team

Report Bug · Request Feature · Documentation