Set up Cryptonym Desk in one minute, and host your own copy free

Cryptonym Desk issues spy-style names for your agents, bots and projects: a two-letter office digraph plus a word, a working alias spliced from two names, and a field codename. It's one HTML file. Setup is:

git clone https://github.com/casareanderson/cryptonym-desk && cd cryptonym-desk
open index.html      # Linux: xdg-open, Windows: start

That's it. It works from file://.

How do you test a page?

Headless Chrome. Every week GitHub opens the page twice, once from a file and once from a plain web server, and checks a full record gets issued: every field filled, the cryptonym starts with a two-letter prefix, the file reference looks right.

It also checks the page has no fetch, XHR, beacon or websocket in it, because the README promises nothing you type leaves your browser. A promise like that should break a build if someone adds a tracker, not sit in a README going stale.

Host your own copy

Fork it, turn on GitHub Pages for main / root, and delete the CNAME file first. It points at my domain, and while it's there your fork won't serve on its own address. That's the one gotcha, and it's in the guide.

Everything it draws from is a plain array at the top of the script, so making it yours is edit, save, reload. Full guide: docs/SETUP.md.

What's the best codename you've given a project? Mine are mostly "test2".

🤖 Drafted with AI assistance from my own homelab notes, logs and repos, then reviewed and edited before publishing.