MyJackfruit

Help
Browse topics · Errors, limits and exit codes

Errors, limits and exit codes

← Back to Do I need a terminal to use standards?

What do a standard reader's exit codes mean?

Short answer

kz-std, the command your AI uses to read a standard, exits 0 when it printed it; 1 to 5 each say why it did not.

Deeper

Also asked:

My AI says it could not read a standard. What now? Ask it for the number after kz-std: exit. 2: no network, or a key failed; try again later. 3: no such standard. 4: a name outside its group; it runs find. 5: several carry the name; it follows one. 1: it was called wrong.

This answer is for people who use the developer kit, GilbPlatform's tools for your computer: the setup link that installs the kit also installs kz-std, by default in the folder kz-std in your home folder. Your AI runs kz-std; you need not type it, as the answer on whether you need a terminal to use standards says. An exit code is the number a command hands back when it ends. When it stops with 1 to 5, kz-std also prints a last line that starts kz-std: exit and the number, with the reason on the line above it.

Exit 0: it printed the standard. A search for words with find also ends 0 when it finds no match, and says no match.

Exit 1: it was called wrong, for example with two links at once, or a link longer than 2048 characters. It prints why, and how to call it.

Exit 2: it could not read GilbPlatform: the network failed, or a key was missing, refused or expired. A record on a gilb.com address that is private, or not there, also gives 2 to a reader with no key. So does a list of a whole group read with no key, and a find that could not read every group. For the network, try again later.

Exit 3: the name or address leads to nothing on GilbPlatform, or to a record there that is not a standard. Do not look for it in files on your computer.

Exit 4: the name is not one kz-std reads in its group of standards. It may tell you to run find with the name, then follow the address find prints; for a file of your own, your AI reads it with its own file tools. A gilb.com address never gives 4.

Exit 5: more than one standard carries the name. kz-std lists each one; follow one of the addresses it lists.

These are the codes as the copy of kz-std read for this answer writes them, dated 13 October 2026. A newer copy may say more; the usage text it prints when it is called wrong is its own list.

The kit's other command, gilb-mint, which finds and adds GilbVeda terms, has its own codes: 0 means GilbPlatform answered the request, 1 means it refused it, and 2 means a problem on your computer, such as not being signed in or no connection. One exception: a dropped connection after a mint, change or retire also gives 2, though the change may have landed; search for the term before you send it again.

Source: kz-std, the copy in the vault (scripts/kz-std/kz-std.mjs, last commit dc8d1ca8ab06cb4edca835eeb91507a285f18877, 2026-10-13): lines 43 (two links or more than 2048 characters: exit 1), 45-50 ("Exit codes: 0 printed · 1 usage · 2 cannot read (key refused or expired, network) · 3 a pack name that resolves to nothing — do NOT look for it in local files · 4 a name outside the pack — read it with your own file tools ... Never for an address on a gilb.com host: private or absent there is 2, no standard there is 3 · 5 more than one standard carries the name (each bearer is listed)"), 18-20 (find: no hit exit 0; a pack unread exit 2), 128-131 (stop: the reason line, then the line kz-std: exit <code>), 134-142 (the usage text: exit 0, 2, 3, 4, 5), 200 (list with: exit 2), 329-357 (exit 3: resolves to nothing, or a record that is no standard of a pack), 270 (exit 4 names `find` then `follow`), 6-7 (no copy kept: each call reads the platform afresh); ai-setup/kz-std-ai-setup.template.md:228 (the line the setup puts in the AI's instruction file: exit 3, 4, 5, 2, 1), :376-385. Seen on 2026-11-10: exit 4 for `get "GilbPlatform.StandardRules.Notice"` (with the find-then-follow advice) and for `get "Agent.SupportAuthor"`; exit 2 for network timeouts, each ending kz-std: exit <n> · vault .... GilbPlatform 4d008a55 (unchanged at the live 498d29a0): scripts/devkit/README.md:18-19 (the same setup link installs that command (by default in ~/kz-std)), :78-83 (gilb-mint exit codes 0, 1, 2 and the dropped-connection exception); at 4d008a55 the platform repository holds no copy of kz-std and no README of it.

Checked against GilbApp d529620.