// 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
Improve is a Pro feature. Free accounts see the button with an upgrade note; the CLI returns a clear upgrade message instead of variants.