promptr

🥇Gold

Promptr is a powerful CLI tool that transforms plain language instructions into filesystem commands using a liquidjs templating system. Ideal for refactoring, code generation, and experimentation, it enhances coding efficiency and creativity.

944350Updated 1w ago

Intermediate15 minutes to implementdevelopment

Saves ~75 min per use

Quick InstallView Source

claude install ferrislucas/promptr

Works with:

ChatGPTGitHub Copilot

Overview

About This Skill

https://github.com/ferrislucas/promptr

How to Use

[{"step":"Install Promptr CLI and ensure Node.js is available. Run `npm install -g promptr` to install globally.","tip":"Use `promptr --version` to verify installation. For project-specific setups, create a `.promptrrc` file to store common configurations."},{"step":"Write your plain language instruction in a text file or pipe it directly to Promptr. Example: `promptr generate 'create a new React component in [src/components] with TypeScript support'`","tip":"Use descriptive placeholders like [DIRECTORY] or [PROJECT_NAME] to make commands reusable across projects."},{"step":"Review the generated command in the output. Promptr uses liquidjs templating, so you can customize the output by modifying the generated liquid template if needed.","tip":"For complex commands, use the `--dry-run` flag to preview changes without executing: `promptr generate '[COMMAND]' --dry-run`"},{"step":"Execute the command in your terminal or integrate it into your build scripts. Promptr supports piping commands to other tools like `xargs` or `jq` for further processing.","tip":"For team collaboration, save generated commands in a `prompts/` directory and document their purpose in a README.md file."},{"step":"Iterate and refine. Use Promptr to generate variations of the same command for different environments (e.g., dev vs. prod) or to handle edge cases you didn't anticipate.","tip":"Combine Promptr with `git` for version-controlled command generation: `git commit -m \"$(promptr generate 'describe changes for [COMMIT]')\"`"}]

Use Cases

Automate repetitive code refactoring tasks to improve code quality and maintainability.

Generate boilerplate code for new components or modules, saving time on setup.

Create custom scripts for experimentation, allowing for rapid prototyping and testing of new ideas.

Simplify command-line interactions by using plain language instructions instead of complex commands.

Best For

GrowthRevOps

Setup & Installation

Quick Install

Terminal

claude install ferrislucas/promptr

Alternative Install (Git Clone)

git clone https://github.com/ferrislucas/promptr

Requirements

Claude Code or compatible AI agent
Works with: ChatGPT, GitHub Copilot

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use Promptr to generate a filesystem command that [ACTION] the [TARGET] based on these requirements: [REQUIREMENTS]. Ensure the command follows best practices for [CONTEXT]. Example: 'Use Promptr to generate a command that recursively renames all .txt files in [DIRECTORY] to .md, preserving directory structure. The command should handle edge cases like filenames with spaces and output a summary of changes.'

Example Output

```bash
# Generated by Promptr CLI v1.2.3
# Command: Promptr generate 'recursively rename all .txt files to .md in [/projects/docs] while preserving directory structure'

# Step 1: Find all .txt files recursively
find /projects/docs -type f -name "*.txt" > /tmp/txt_files.txt

# Step 2: Process each file with safe handling for spaces/special chars
while IFS= read -r file; do
  dir=$(dirname "$file")
  base=$(basename "$file" .txt)
  new_file="$dir/$base.md"
  if [ ! -f "$new_file" ]; then
    mv -n "$file" "$new_file" && echo "Renamed: $file → $new_file"
  else
    echo "Skipped (exists): $file → $new_file"
  fi
done < /tmp/txt_files.txt

# Step 3: Cleanup temp file
rm /tmp/txt_files.txt

# Summary
Total files processed: 42
Successfully renamed: 38
Skipped (already exists): 4
```

**Promptr Context**: Used liquidjs templating to handle path escaping and edge cases. The command includes safety checks to prevent overwriting existing files and provides verbose output for auditability. The generated command is idempotent and can be safely rerun.