@prompd/cli

The command-line toolkit for compiling, running, and publishing composable AI prompts. Automate everything from local dev to CI/CD.

npm install -g @prompd/cli

Quick Start

1. Install the CLI globally

npm install -g @prompd/cli

2. Create your first .prmd file

prompd init my-prompt

3. Compile the prompt

prompd compile my-prompt.prmd

4. Run it against a provider

prompd run my-prompt.prmd --provider openai

Everything you need to author, validate, and distribute prompt packages.

prompd compile

Resolve inheritance, inject context, substitute parameters, and output provider-ready prompts.

prompd run

Compile and execute a .prmd file against a configured provider in a single step.

prompd validate

Check .prmd files and packages for syntax errors, missing fields, and schema violations.

prompd install

Install a package from the registry with automatic dependency resolution.

prompd search

Search the registry by keyword, namespace, or package type.

prompd publish

Pack and publish your project to the registry for others to use.

Configure providers, environment variables, and project settings.

Configure API keys and defaults for OpenAI, Anthropic, and other LLM providers. Switch providers per-prompt or per-project.

Store secrets in .env files. The CLI automatically loads project-level and global .env on every command.

Project-level configuration for default provider, output format, compilation flags, and registry endpoint.

Common CLI workflows you can run today.

Compile a .prmd file that inherits from a registry package and includes local context files.

prompd compile summarizer.prmd --output compiled.json

Execute a prompt with custom parameter values passed from the command line.

prompd run summarizer.prmd -p topic="Kubernetes" -p audience="beginners"

Bundle your project into a .pdpkg archive and publish it to the registry.

prompd publish --access public

Python CLI

pip install prompd

From source

git clone https://github.com/Prompd/prompd-cli