{"canonical_url":"https://engineer.company/cli/","content_markdown":"# Engineer in a terminal\n\nThis site answers on four protocols, out of one folder of files on one server.\nIf you live in a terminal, you never have to open a browser to read it.\n\nThe public site formats below need no account, key or client you have to build. Source repositories are private; the SSH section explains their access boundary.\n\n## Every page is also Markdown\n\nEach page has an HTML version and clean Markdown beside it. Ask for either.\n\n```sh\n# The twin, by name\ncurl -sL https://engineer.company/about/index.md\n\n# Or ask the server for it and let it choose\ncurl -sL -H 'Accept: text/markdown' https://engineer.company/about/\n```\n\nPipe it into whatever renders Markdown for you:\n\n```sh\ncurl -sL https://engineer.company/portfolio/index.md | glow -\ncurl -sL https://engineer.company/what-it-costs/index.md | bat -l md\n```\n\nThe other languages work the same way — `/da/about/index.md`, `/uk/about/index.md`.\n\nBeside each page's QR code, the format links also offer JSON,\n[gemtext](/glossary/#gemtext) and a\nGopher menu. The JSON at `/about/index.json` contains that page's metadata and\nMarkdown content; `/feed.json` is the separate portfolio feed. Request\n`index.json` directly: `Accept: application/json` does not select it from the\nHTML URL.\n\n**View PDF** opens the page's PDF in a new tab; **Download PDF** offers the same\nfile for download. These static files are generated before publication, using\nthe page's print layout. The links use native browser controls and add no\nbrowser JavaScript.\n\n## A Gemini capsule\n\nGemini is a small protocol with the sensibilities of this site built in: text\ndocuments over TLS, no scripting, no cookies, nothing to track you with. Every\npage of this site exists as gemtext too.\n\n```text\ngemini://engineer.company/\n```\n\nAny Gemini client reads it — **Amfora**, **Lagrange** or **Bombadillo** in a\nterminal, **Castor** or **Kristall** in a window. On a Mac with Homebrew:\n\n```sh\nbrew install amfora \u0026\u0026 amfora gemini://engineer.company/\n```\n\n## A Gopher hole\n\nGopher is a menu protocol from 1991 — plain TCP, no encryption, no scripting —\nand the site is a set of menus there, one per directory.\n\n```text\ngopher://engineer.company/\n```\n\n**Lynx** speaks it out of the box, as do **Bombadillo** and **gopher-cli**. Or\nask for a selector by hand, which is the entire protocol in one line:\n\n```sh\nprintf '/contact\\r\\n' | nc engineer.company 70\n```\n\n## An onion service\n\nThe same site over [Tor](/glossary/#tor), for a reader whose network should not\nknow what they are reading:\n\n```text\nhttp://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/\n```\n\nIt is plain `http://` deliberately: an [onion](/glossary/#onion) address encodes the service's identity public key. Tor authenticates the service and encrypts the connection before HTTP is exchanged. With Tor running locally, `curl` reaches it directly:\n\n```sh\ncurl -sL --socks5-hostname 127.0.0.1:9050 \\\n  http://engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion/index.md\n```\n\n## Reading the work as data\n\nThe portfolio is syndicated in three formats, each carrying the full text of\nevery item rather than a teaser:\n\n```sh\ncurl -s https://engineer.company/feed.json | jq -r '.items[] | .title'\ncurl -s https://engineer.company/index.xml     # RSS\ncurl -s https://engineer.company/atom.xml      # Atom\n```\n\nAnd the site keeps a map of itself for anything that reads rather than crawls:\n\n```sh\ncurl -s https://engineer.company/llms.txt\ncurl -s https://engineer.company/humans.txt\ncurl -s https://engineer.company/.well-known/security.txt\n```\n\n## The source, over SSH\n\nThe site's source is kept in private repositories on our git server. Authorized collaborators access them over SSH using an approved SSH key:\n\n```sh\nssh git.engineer.company\n```\n\nThe command opens the server interface. Which repositories you can inspect depends on the access granted to your SSH key. The public page at [git.engineer.company](https://git.engineer.company/) describes the service; it does not publish repository contents.\n\n## Why any of this exists\n\nOne deploy writes one folder, and four front doors read it — so none of them can\ndrift from the others, and none of them is a separately maintained copy of the\nsite. A page that reads well as gemtext is a page whose structure is real rather\nthan painted on, which is the same property that makes it read well in a screen\nreader and print correctly on paper. The [credits page](/credits/) names the\ndaemons behind each one.\n\nWe build things that read well without a browser because that is usually a sign\nthey were built properly —\n[ask us to build you one](/contact/) *(pipes, exit codes and all)*.\n\n\u003chttps://engineer.company/cli/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Read engineer.company from the command line: Markdown over HTTP, a Gemini capsule, a Gopher hole and an onion service — the same site, four ways.","formats":{"gemtext":"https://brand.engineer.company/cli/index.gmi","gopher":"https://brand.engineer.company/cli/gophermap","html":"https://brand.engineer.company/cli/","json":"https://brand.engineer.company/cli/index.json","markdown":"https://brand.engineer.company/cli/index.md","pdf":"https://brand.engineer.company/cli/index.pdf"},"kind":"page","language":"en","title":"Engineer in a terminal","url":"https://brand.engineer.company/cli/","version":1}