docs: no # comment at the end of a shell line (zsh does not treat it as a comment) #92

Some shell blocks in the docs end a command line with a # comment. Interactive zsh does not treat # as the start of a comment unless the option interactivecomments is on, and it is off by default. So a reader who pastes such a line into zsh passes the # and the words after it to the command as arguments.

For example, read -rs TOKEN # paste the token, ... makes zsh's read try to set variables named #, paste, the and so on. VERSION=0.1.0 # the new version does not set VERSION at all.

Lines seen on 2026-10-17 (on main at f6e47bb):

• README.md: 103, 111, 118
• AGENTS.md: 50, 51
• docs/setup.md: 311, 545 (feat: install script and nodkey update #88 fixes the VERSION= line of section 13)
• docs/manual-telegram-test.md: 62, 65, 96, 107, 392

Comments in TOML blocks are fine: they are config, not shell.

Done when

• No shell block in README.md, AGENTS.md or docs/ has a command line that ends in a # comment. A note goes on its own line above the command, or into the text.
• A short check finds none (for example a test that reads the shell blocks of these files, or a script in CI).