Promptrix CLI

> 🚀 AI-powered prompt optimization from your terminal


Promptrix CLI brings the power of AI prompt optimization directly to your development workflow. Optimize prompts for ChatGPT, Claude, Gemini, and more with a simple command.

🎯 Features

- Instant Optimization: Transform any prompt into a more effective version
- Advanced Methods: 21+ optimization methods with category and complexity filtering
- Multi-Model Support: Optimize for specific AI models (GPT-4, Claude, Gemini, etc.)
- Multiple Styles: Choose from concise, detailed, creative, or technical outputs
- Pipe Support: Integrate seamlessly with Unix tools and scripts
- Free Tier: 100 optimizations per month at no cost
- Developer-Friendly: JSON output, quiet mode, and scriptable interface

📦 Installation

``bash
npm install -g promptrix-cli
`

Or use directly with npx:

`bash
npx promptrix-cli "Your prompt here"
`

🔑 Authentication

Get your free API key (100 optimizations/month):

1. Visit https://promptrix.co/developers
2. Sign up for a free account
3. Copy your API key
4. Configure the CLI:

`bash
promptrix config --key your-api-key-here
`

Alternatively, set via environment variable:

`bash
export PROMPTRIX_API_KEY=your-api-key-here
`

📖 Usage

$3

`bash
promptrix "Explain quantum computing"
`

$3

`bash


Optimize for GPT-4

promptrix "Write a Python function" --target gpt-4

Optimize for Claude

promptrix "Analyze this text" --target claude-3

Optimize for Gemini

promptrix "Create a story" --target gemini
`

$3

`bash


Concise output

promptrix "Summarize machine learning" --style concise

Detailed explanation

promptrix "Explain Docker" --style detailed

Creative writing

promptrix "Write a story opening" --style creative

Technical documentation

promptrix "Document this API" --style technical
`

$3

`bash


From file

cat prompt.txt | promptrix

From another command

echo "Explain this concept" | promptrix

Chain with other tools

promptrix "Generate SQL query" | mysql database
`

$3

`bash
promptrix "Your prompt" --format json
`

Output:
`json
{
"improvedPrompt": "...",
"improvements": ["..."],
"confidence": 0.95
}
`

$3

`bash
promptrix usage
`

Output:
`
📊 Promptrix Usage Stats
━━━━━━━━━━━━━━━━━━━━━━
Used: 42 / 100 (42%)
Remaining: 58
Resets: 01/01/2024
`

$3

List available optimization methods:

`bash
promptrix methods
`

Output with enhanced metadata:
`
🔧 Available Optimization Methods
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Your tier: PRO
Available: 21 methods
Locked: 0 methods

✅ Available Methods:
🧠 Chain of Thought
Adds systematic reasoning steps to prompts
⭐ Basic • 🧠 Reasoning & Analysis • ⏱️ 5-15s
Tier: FREE
Use: promptrix "prompt" --method CHAIN_OF_THOUGHT

✅ Chain-of-Verification
Reduces hallucinations by adding fact-checking
⭐⭐ Intermediate • 🔍 Verification & Quality • ⏱️ 15-30s
Tier: PRO
Use: promptrix "prompt" --method CHAIN_OF_VERIFICATION

💡 Tip: Filter methods with --category or --complexity flags
`

$3

`bash


Show only verification methods

promptrix methods --category verification

Show only reasoning methods

promptrix methods --category reasoning

Available categories:

- verification: Reduce hallucinations, improve accuracy

- reasoning: Systematic thinking, multi-perspective analysis

- structure: Organize output, format responses

- learning: Learn from examples, improve patterns

- planning: Break down complex tasks, strategize

`

$3

`bash


Show only basic methods (fast, simple)

promptrix methods --complexity basic

Show only advanced methods (complex, thorough)

promptrix methods --complexity advanced

Complexity levels:

- basic: ⭐ Quick optimization (5-15s)

- intermediate: ⭐⭐ Balanced approach (15-30s)

- advanced: ⭐⭐⭐ Deep optimization (25-45s)

`

$3

`bash


Find advanced reasoning methods

promptrix methods --category reasoning --complexity advanced

Find basic verification methods

promptrix methods --category verification --complexity basic
`

$3

`bash


Apply specific optimization method

promptrix "Explain blockchain" --method CHAIN_OF_VERIFICATION

Use expert panel method for multiple perspectives

promptrix "Design a system" --method EXPERT_PANEL_SIMULATOR
`

🛠️ Advanced Usage

$3

The CLI stores configuration in ~/.promptrix/config.json:

`json
{
"apiKey": "your-key",
"defaultStyle": "concise",
"defaultTargetModel": "gpt-4",
"analytics": true
}
`

$3

`bash
#!/bin/bash


optimize_prompts.sh

for file in prompts/*.txt; do
optimized=$(cat "$file" | promptrix --quiet)
echo "$optimized" > "optimized/$(basename "$file")"
done
`

$3

`yaml


GitHub Actions Example


- name: Optimize prompts
run: |
npm install -g @promptrix/cli
echo "${{ secrets.PROMPTRIX_API_KEY }}" | promptrix config --key -
promptrix "Deploy message" > deploy_message.txt
`

🎨 Command Reference

| Command | Description |
|---------|-------------|
| promptrix [prompt] | Optimize a prompt |
| promptrix methods | List optimization methods |
| promptrix methods --category | Filter methods by category |
| promptrix methods --complexity | Filter methods by complexity |
| promptrix methods show | Show method details |
| promptrix --help | Show help message |
| promptrix --version | Show version |
| promptrix config --key | Set API key |
| promptrix usage | Check usage stats |

$3

| Option | Description | Example |
|--------|-------------|---------|
| --method | Use specific optimization method | --method CHAIN_OF_VERIFICATION |
| --target | Target AI model | --target gpt-4 |
| --style