// docs / improve
One-shot variants, versioned.
Improve is the quick rewrite pass: PLE generates a few variants of your prompt, you pick the one that reads best, and it lands as a normal version. Nothing is overwritten.
In the editor
Open a prompt and hit Improve next to Save/Commit. You get variants side by side, each with the strategy it tried; choose one and it becomes a new version with a Loop(strategy) changelog. Don't like any? Cancel, and nothing is saved. Since it's just a version, rollback undoes it like any other commit.
From the terminal
ple improve my-code-review
ple improve my-code-review --focus "shorter, explicit output format"
# variants render numbered → pick one (0 = cancel) → saved as a new versionSame flow, no browser. --focus steers what the variants optimize for. The run reports its token usage at the end; it spends from your monthly AI budget.
Improve vs. Loop
Improve one round, judged by YOU reading the variants
Loop multi-round, judged by YOUR AGENT's real outputs (--exec)Improve is for "this prompt reads clumsy, tighten it". When the question is "which wording actually performs better in my pipeline", graduate to Loop: it runs every variant through your own agent command and shows you the outputs before you choose.
Requirements
Free accounts get 3 AI Improves a month in the web editor, so you can try it on your own prompts. The editor shows how many are left, and the count resets on the 1st of each month (UTC). A failed request does not use one up. More Improves than that, Loop and CLI variants (ple improve) are Pro features, drawn from Pro's 1M AI tokens a month. On Free, the CLI shows a clear upgrade message instead of variants.