promptdeck

promptdeck is a Go CLI for lightweight and reproducible prompt templating.

It helps teams turn small JSON files into prompt variants and controlled experiment batches without relying on spreadsheets or heavyweight prompt platforms.

Support

Quickstart

Install

brew install itamaker/tap/promptdeck

You can also download binaries from GitHub Releases.

Current release archives:

• macOS (Apple Silicon/arm64): promptdeck_0.1.1_darwin_arm64.tar.gz
• macOS (Intel/x86_64): promptdeck_0.1.1_darwin_amd64.tar.gz
• Linux (arm64): promptdeck_0.1.1_linux_arm64.tar.gz
• Linux (x86_64): promptdeck_0.1.1_linux_amd64.tar.gz

Each archive contains a single executable: promptdeck.

First Run

Run:

promptdeck matrix -template examples/review.tmpl -matrix examples/matrix.json

Requirements

• Go 1.22+

Run

Render one prompt:

go run . render -template examples/review.tmpl -vars examples/vars.json

Render a matrix:

go run . matrix -template examples/review.tmpl -matrix examples/matrix.json

Build From Source

make build

go build -o dist/promptdeck .

What It Does

1. Loads Go text templates from local files.
2. Renders one prompt from a JSON variable object or many prompts from a JSON array.
3. Expands matrix inputs into Cartesian prompt combinations.
4. Prints output to stdout or writes prompt batches to files.

Notes

• Use -out-dir when you want prompt variants as individual files.
• Maintainer release steps live in PUBLISHING.md.

Contributors ✨

Zhaoyang Jia