Skip to main content
The Prompts.dev CLI provides a complete toolkit for creating, publishing, and managing prompt packages. Choose the installation method that works best for your workflow.

​
Prerequisites

  • Go 1.25.0 or higher (for go install or building from source)
  • Git (for cloning the repository)

​
Installation Methods

1

Using go install

The quickest way to install the CLI if you have Go installed:
go install github.com/topboyasante/prompts/cmd/cli@latest
This installs the binary as cli in your $GOPATH/bin directory. Make sure $GOPATH/bin is in your PATH.
2

Build from source

Clone the repository and build the CLI binary:
git clone https://github.com/topboyasante/prompts.git
cd prompts
make build-cli
The make build-cli command creates a binary at ./bin/prompt. The make install-cli command installs it to your $GOPATH/bin.
See the Makefile for the exact build commands used.
3

Download prebuilt binary

Download the latest release binary for your platform from the releases page:
macOS/Linux
# Download and make executable
chmod +x prompt
sudo mv prompt /usr/local/bin/
Windows
# Move to a directory in your PATH
move prompt.exe C:\Windows\System32\prompt.exe

​
Verify Installation

Confirm the CLI is installed correctly: 
prompt --help
You should see output similar to: 
Prompt registry CLI

Usage:
  prompt [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command
  init        Scaffold a prompt package
  install     Install prompt package
  login       Login with OAuth provider
  publish     Publish current prompt package
  run         Render prompt with variables
  search      Search prompts

Flags:
  -h, --help   help for prompt

Use "prompt [command] --help" for more information about a command.

​
Configuration

The CLI stores configuration in ~/.prompts/:
  • ~/.prompts/config.json - Authentication tokens
  • ~/.prompts/[package-name]/ - Installed prompt packages
The config directory is created automatically on first run (see main.go:364-370).

​
Environment Variables

Configure the CLI behavior with environment variables:
​
PROMPTS_API_URL
string
default:"http://localhost:8080/v1"
The base URL for the Prompts.dev API server.
export PROMPTS_API_URL=https://api.prompts.dev/v1
The CLI automatically loads .env files from the current directory or any parent directory (see main.go:60-82).

​
Next Steps

CLI Commands

Learn about all available commands and their options

Workflow Guide

Follow an end-to-end example of creating and publishing prompts

Build docs developers (and LLMs) love

Get started for freeTalk to us