GET STARTED / YOUR FIRST PROMPT

Your first prompt

End-to-end walkthrough using the verified promptlm-cli commands.

1. Create a prompt repository

Most CLI commands operate against an active project — a Git-backed prompt store on disk.

Create a new one (and have promptLM register it as the active repo):

promptlm-cli repo create \
  --dir ~/prompts \
  --name myorg/my-prompts

Or clone an existing remote:

promptlm-cli repo clone \
  --repo https://github.com/myorg/my-prompts.git \
  --target ~/prompts

To switch the active repo to one already on disk: promptlm-cli repo use --path ~/prompts.

2. Create a prompt draft

promptlm-cli prompt create \
  --name support_welcome \
  --group support \
  --userMessage "Greet {customer_name} warmly."

--placeholder (repeatable, key=value) can be passed alongside to override placeholder defaults.

The command returns the new prompt’s id — keep it for the next steps.

3. Inspect the latest version

promptlm-cli prompt show --id <prompt-id>

4. Release the prompt

promptlm-cli prompt release --id <prompt-id>

Note

When promptlm.release.promotion.mode=pr_two_phase is configured, releases are two-step: the command above opens a release PR, and after that PR is merged you complete the release with:

promptlm-cli prompt release complete --id <prompt-id> --pr <pr-number>

In the default direct mode no second step is needed.

Once released, the prompt is reachable from the client SDKs as a versioned JSON bundle.