# What do a standard reader's exit codes mean?

Checked 2026-11-15 against GilbApp d5296208bbffa2ab70076e6194f5537c4be1ddf7.

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](http://support.gilb.com/help/do-i-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 &lt;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 &lt;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.
