promptctl

Install

$ brew tap oleg-koval/tap
$ brew install --cask oleg-koval/tap/promptctl

Upgrade: brew upgrade --cask oleg-koval/tap/promptctl

Verify

$ promptctl version
$ promptctl init
$ promptctl create "your idea here"

After promptctl init, you can optionally add shell aliases so you don't have to type promptctl every time. If you accept, you'll get prompt and p (or custom names if those are already in use).

Aliases

Use prompt or p instead of promptctl by adding shell aliases. Run promptctl init and accept when asked to add aliases; they are written to your shell profile (~/.zshrc or ~/.bashrc). If prompt or p is already defined, you'll be asked for alternative names.

$ prompt create "analyze my startup idea"
$ p list
$ p send review --file=main.go

After adding aliases, reload your shell: source ~/.zshrc (or ~/.bashrc).

What is promptctl?

create – Transforms raw intent into structured prompts (personas, task decomposition, output format, constraints).

run – Runs YAML templates with variables, file reading, and conditionals. Includes starters for code review, debugging, architecture, commit messages, code explanation.

$ promptctl create "analyze my SaaS idea for the Dutch market, be critical"
$ promptctl review --file=src/auth.ts
$ promptctl review --file=main.go | claude

Commands

• create – promptctl create "intent" [--save=name] [--format=xml|markdown] [--persona="..."] [--score] [--no-rate]. Use --score to print a 0–100 quality score and hints.
• run / send / cost – Run template by name; send to LLM with cost tracking; estimate cost (use --compare for all models).
• list, add, edit, show, copy, vars – Manage templates.
• models, config, init – List models/pricing; set provider and API key; interactive setup.

$ promptctl create "plan k8s migration" --score
$ promptctl cost review --file=main.go --compare
$ promptctl send review --file=auth.ts --model=gpt-5

Mac app

Native macOS app: same Try flow in a window. Download for Mac (DMG) from GitHub Releases — get promptctl-macos.dmg from the latest release assets.

Troubleshooting

Formula not found:

$ brew untap oleg-koval/tap
$ brew tap oleg-koval/tap
$ brew install --cask oleg-koval/tap/promptctl

Outdated version: brew update && brew upgrade --cask oleg-koval/tap/promptctl