PromptyDumpty

A lightweight, universal package manager for AI coding assistants (prompts, instructions, rules, workflows, etc.).

What is it?

PromptyDumpty lets you install and manage prompt packages across different AI coding assistants like GitHub Copilot, Claude, Cursor, Gemini, Windsurf, and more.

Why?

• Share prompts easily: Package and distribute your team's prompts
• Works everywhere: One package works with multiple AI coding assistants
• Simple: Just YAML files and Git repos, no complex setup
• Safe: Clean installation and removal, clear tracking

Installation

Using pip

pip install prompty-dumpty

From Source

git clone https://github.com/dasiths/PromptyDumpty.git
cd PromptyDumpty
pip install -e .

Verify Installation

dumpty --version

Quick Start

# Initialize in your project
dumpty init

# Install a package
dumpty install https://github.com/org/my-prompts

# List installed packages
dumpty list

# Update packages
dumpty update --all

# Remove a package
dumpty uninstall my-prompts

How it Works

1. Auto-detects your AI agent (checks for .github/prompts/, .claude/commands/, etc.)
2. Installs package files to the right directories
3. Tracks everything in a lockfile for easy management
4. Organizes files by package name for clean removal

Supported AI Coding Assistants

• GitHub Copilot (.github/)
• Claude (.claude/)
• Cursor (.cursor/)
• Gemini (.gemini/)
• Windsurf (.windsurf/)
• Cline (.cline/)
• Aider (.aider/)
• Continue (.continue/)
• OpenCode (.opencode/)

Usage Examples

Initialize a Project

# Auto-detect agents in current directory
dumpty init

# Initialize with specific agent
dumpty init --agent copilot

Install Packages

# Install from GitHub repository
dumpty install https://github.com/org/my-prompts

# Install specific version tag
dumpty install https://github.com/org/my-prompts --version 1.0.0

# Install for specific agent
dumpty install https://github.com/org/my-prompts --agent copilot

Manage Packages

# List installed packages
dumpty list

# Show detailed information
dumpty list --verbose

# Update all packages
dumpty update --all

# Update specific package
dumpty update my-prompts

# Uninstall a package
dumpty uninstall my-prompts

Requirements

• Python 3.9 or higher
• Git

Creating Packages

Want to create your own prompt packages? See the full guide at dumpty.dev/creating-packages.

Quick example - define what your package provides in dumpty.package.yaml:

name: my-workflows
version: 1.0.0
description: Custom development workflows
manifest_version: 1.0
author: Your Name
license: MIT

agents:
  copilot:
    prompts:
      - name: code-review
        description: Code review workflow
        file: src/review.md
        installed_path: code-review.prompt.md
  
  claude:
    commands:
      - name: code-review
        description: Code review command
        file: src/review.md
        installed_path: review.md

Documentation

📚 Full documentation available at dumpty.dev

• Getting Started Guide
• Creating Packages
• Full Documentation

Contributing

Contributions are welcome! Please visit our GitHub repository for more information.

Links

• Homepage: dumpty.dev
• Documentation: dumpty.dev/docs
• GitHub: github.com/dasiths/PromptyDumpty
• PyPI: pypi.org/project/prompty-dumpty
• Issues: github.com/dasiths/PromptyDumpty/issues

License

MIT License - see the LICENSE file for details.