promptvault

Version control and registry for prompt assets. Part of the prompttools suite.

Features

• Package manifests -- Define prompt packages with promptvault.yaml, including metadata, prompt entries, dependencies, and quality gates
• Local registry -- Publish, install, search, and list versioned prompt packages in a local file-system registry
• Dependency resolution -- Resolve dependencies with semver range matching (caret ^, tilde ~, PEP 440 ranges)
• Lockfile management -- Generate and verify lockfiles for reproducible installations with integrity checking
• CLI -- Full command-line interface for all operations

Installation

pip install promptvault-ai

Quick Start

Initialize a package

promptvault init --name @my-org/my-prompts --author "Your Name"

This creates a promptvault.yaml manifest:

name: '@my-org/my-prompts'
version: 0.1.0
description: A prompt package
author: Your Name
license: MIT
prompts: []
dependencies: {}
quality:
  lint: optional
  test: optional
  format: optional

Add prompts to the manifest

Edit promptvault.yaml to declare your prompt files:

prompts:
  - file: prompts/greeting.yaml
    name: greeting
    description: A friendly greeting prompt
    variables: [user_name]
    model: claude-4-sonnet

Publish to local registry

promptvault publish

Install dependencies

promptvault install

Search the registry

promptvault search greeting

Verify lockfile integrity

promptvault verify

CLI Reference

Global Options

• --registry <path> -- Override the default registry location (~/.promptvault/registry/)
• --format text|json -- Output format (default: text)

Version Ranges

Dependency version ranges follow semver conventions:

Python API

from promptvault import LocalRegistry, PackageManifest, resolve_dependencies

# Create a registry
registry = LocalRegistry()

# Publish a package
entry = registry.publish(Path("./my-package"))

# Search
results = registry.search("greeting")

# Resolve dependencies
manifest = PackageManifest(...)
resolved = resolve_dependencies(manifest, registry)

Development

pip install -e ".[dev]"
pytest

License

MIT