@enprompta/cli

The Enprompta command-line interface — evaluate, observe, and iterate on the AI you ship, straight from your terminal. Built for coding agents (Claude Code, Cursor) and humans alike: JSON output by default, --format pretty for tables.

Install

npm install -g @enprompta/cli
# or run without installing
npx @enprompta/cli --help

Authenticate

Get an API key from Dashboard → Settings → API Keys (ep_...), then:

enprompta auth login --api-key ep_your_key_here
enprompta auth status

Credentials resolve in this order: --api-key flag → ENPROMPTA_API_KEY env → saved profile (~/.enprompta/config.json). Use --profile <name> or ENPROMPTA_PROFILE to select a profile, and --base-url / ENPROMPTA_BASE_URL for staging or self-hosted instances.

enprompta auth login --name staging --api-key ep_... --base-url https://staging.enprompta.com
enprompta auth use staging
enprompta auth list

Commands

Prompts

enprompta prompt list --search summariser --limit 20
enprompta prompt get <prompt-id>

Evaluations

# Score a single prompt
enprompta eval --prompt-a "You are a helpful assistant…"

# Compare two prompts (inline or from files)
enprompta eval --prompt-a @prompts/v2.txt --prompt-b @prompts/v1.txt

# Compare against a saved prompt version, re-running on file change
enprompta eval --prompt-a @draft.txt --prompt-name summariser --version 3 --watch

Traces (observability)

enprompta trace list --provider openai --limit 10
enprompta trace get <trace-id>
enprompta trace analytics --days 30

Raw API passthrough

Covers every endpoint, modelled on gh api:

enprompta api GET /api/v1/traces/analytics --query days=7
enprompta api POST /api/v1/prompts --data '{"title":"My Prompt","content":"Hello {{name}}"}'

Output

--format json (default) prints pretty-printed JSON to stdout — predictable for piping into agents and scripts. --format pretty renders tables/key-value views for humans. Errors go to stderr (as JSON in json mode). Use --quiet to suppress output.

License

MIT