diff --git a/README.md b/README.md index 29a4f41..432983d 100644 --- a/README.md +++ b/README.md @@ -1,46 +1,33 @@ # Promptr -Promptr is a CLI tool that lets you use plain English to instruct OpenAI LLM models to make changes to your codebase.

+Promptr is a CLI tool that lets you use plain English to instruct OpenAI LLM models to make changes to your codebase. Changes are applied directly to the files that you reference from your prompt.

## Usage `promptr [options] -p "your instructions" ...` - -

-## Examples -__Cleanup the code in a file__ -```bash -$ promptr -p "Cleanup the code in src/index.js" -``` -Promptr recognizes that the file `src/index.js` is referenced in the prompt, so the content of `src/index.js` is sent to the model along with the user's prompt. -
The model's response is automatically applied to the relevant files. -

-
+I've found this to be a good workflow: +- Commit any changes, so you have a clean working area. +- Author your prompt in a file. The prompt should be specific clear instructions. +- Make sure your prompt contains the relative paths of any files that are relevant to your instructions. +- Use Promptr to execute your prompt. Provide the path to your prompt file using the `-p` option: +`promptr -p my_prompt.txt` -__Alphabetize the methods in all of the javascript files__ -```bash -$ promptr -p "Alphabetize the method names in all of these files" $(git ls-tree -r --name-only HEAD | grep ".js" | tr '\n' ' ') -``` -The command above uses `git-tree`, `grep`, and `tr` to pass a list of javascript file paths to promptr. +Promptr will apply the model's code directly to your files. Use your favorite git UI to inspect the results.

+
+
+ +## Examples + The PR's below are good examples of what can be accomplished using Promptr. You can find links to the individual commits and the prompts that created them in the PR descriptions. - https://github.com/ferrislucas/promptr/pull/38 - https://github.com/ferrislucas/promptr/pull/41

-I've found this to be a good workflow: -- Commit any changes, so you have a clean working area. -- Author your prompt in a file. The prompt should be specific clear instructions. -- Make sure your prompt contains the relative paths of any files that are relevant to your instructions. -- Use Promptr to execute your prompt. Provide the path to your prompt file using the `-p` option: -`promptr -p my_prompt.txt` - -Promptr applies the model's response to your files. Use your favorite git UI to inspect the results. -

## Templating Promptr supports templating using [liquidjs](https://liquidjs.com/), which allows users to incorporate templating commands within their prompt files. This feature enhances the flexibility and reusability of prompts, especially when working on larger projects with repetitive patterns or standards.