Doctor and exit codes

Check the install and read what an exit code means

Check the install and the vault

zyler doctor

doctor checks that the command is installed correctly, that the vault's files can be read, and that the vault's write lock is the one the app uses. Each line says ok, warn, or fail with a reason. It exits with code 11 when a check fails; warnings alone exit 0.

The command is not found

Install it from Settings → General → Command line tool, then open a new terminal. If the app reports a conflicting command or a permission error, keep that message and contact support.

Exit codes

CodeMeaningWhat to do
0Done
1Unexpected failureReport it; run again with ZYLER_DEBUG=1 for details
2Bad argumentsCheck the command with zyler <command> -h
3No vault foundUse --vault, ZYLER_VAULT, or cd into the vault; zyler vaults lists them
4The note matched nothing, or more than oneUse the note's id from zyler ls
5Someone else wrote firstRead the note again and redo the change
6The note is lockedUnlock it from the note's ⋯ menu in the app
7The edit was refusedCheck block ids and that --old matches zyler cat exactly
8The write may or may not have happenedRead the note before trying again
9The history snapshot failed, so nothing was writtenCheck free disk space and try again
10A file is unreadable, or was made by a newer ZylerUpdate Zyler; do not recreate the file
11doctor found a failing checkRead the fail lines
12The vault is read-only hereReads still work; check folder permissions
13Another program holds the note fileTry again in a moment

With --json, every outcome, including errors, is one JSON object with an ok field.

Edit this guide on GitHub