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

toolchain.scaffold_write_failed

On this page

You ran jadpo new or jadpo package new, and writing its files failed, usually because the folder they go in can't be written.

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

Why Jadpo refuses it

jadpo new writes a whole project or none of it. When the operating system refuses one of its files, it removes what it had already written and says which file and why, so you are never left with half a project that doesn't check.

Jadpo won't change permissions or pick another folder for you: both are decisions about your files.

What it looks like

The folder apps is read-only, and the project is asked for inside it:

shell
mkdir appschmod a-w appsjadpo new apps/todo-app
jadpo new

error apps/todo-app couldn't be written

reason
Writing it failed: Permission denied (os error 13). jadpo new removed what it had written, so apps/todo-app is as it was.
next
Check that apps/todo-app can be written, then run jadpo new apps/todo-app again (human)
rule
toolchain.scaffold_write_failed
help
https://jadpo.dev/docs/errors/toolchain.scaffold_write_failed

(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 who may write where the project goes.

How to fix it

If the folder should be writable, let yourself write to it, then run the command again:

shell
chmod u+w appsjadpo new apps/todo-app

The whole project is written into apps/todo-app.

If the folder should stay read-only, make the project somewhere you can write:

shell
jadpo new todo-app
output
Created todo-app    jadpo  X.Y    route  POST /hello    files  14 writtennext: cd todo-app && jadpo dev  serves it on http://localhost:3000

The project is in todo-app, and apps is untouched.

Markdown for agents: /docs/errors/toolchain.scaffold_write_failed.md.Built from Jadpo main at aee2e8f.