Jadpo is experimental and not ready for production. These docs follow the compiler's main branch as of 5 Nov 2026. What's built · Install 0.3.0
jadpo
ReferenceErrors

ErrorsTools · rule

configuration.local_changed

On this page

Something else saved .env.local while jadpo config set was saving a value in it.

Area 14, Tools; not declinable; the next step is usually the human's.

Why Jadpo refuses it

jadpo config set saves a value by reading .env.local, writing a new file beside it, and putting that in the old one's place. Just before the swap, it reads .env.local again. If the file changed in between, because an editor, a script or a second jadpo config set saved it, the swap would throw that change away, so the command stops, and .env.local keeps what the other program saved.

Jadpo won't merge the two saves for you: the other change may be a secret, and only you know which value you meant.

What it looks like

Only two programs saving at the same moment raise this error, so this output is copied from a real run rather than checked by the docs. A script was rewriting .env.local over and over while a value was typed at the prompt:

shell
jadpo config set mail_api_key
output
? Enter MAIL_API_KEY hiddenerror: `.env.local` changed while it was being updated  reason: Something saved the file after it was read, and replacing it now would lose that change.  next: Run the command again (human)  rule: configuration.local_changed  help: https://jadpo.dev/docs/errors/configuration.local_changed

(human) at the end of the next: line tells your coding agent to stop and ask you which fix you want, because the choice is yours to make: it decides which of the two saves .env.local keeps.

How to fix it

If the other save was a one-off, such as an editor saving the file, run the command again and type the value once more:

shell
jadpo config set mail_api_key

The value is saved beside whatever the other program wrote, since the command reads the file afresh.

If a program keeps rewriting .env.local, stop it first, or give the value in the environment instead, which nothing writes:

shell
export MAIL_API_KEYread -rs MAIL_API_KEYjadpo dev

The environment wins over .env.local, and nothing is written.

Markdown for agents: /docs/errors/configuration.local_changed.md.Built from Jadpo main at aee2e8f.