https://astrohacker.com/blog Dispatches from the Astrohacker portfolio. Mon, 10 Aug 2026 12:00:00 GMT https://validator.w3.org/feed/docs/rss2.html https://github.com/jpmonette/feed en Copyright (C) 2026 Astrohacker https://astrohacker.com/blog/2026-08-10-keypears-coming-home-to-astrohacker https://astrohacker.com/blog/2026-08-10-keypears-coming-home-to-astrohacker Mon, 10 Aug 2026 12:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-08-02-nexus-host-and-ahnexus-chat https://astrohacker.com/blog/2026-08-02-nexus-host-and-ahnexus-chat Sun, 02 Aug 2026 20:30:00 GMT _`), topics, `/me`, channel list, PMs, broadcasts, Login avatar (CLI + form), Settings password change, files browse/transfer. - **Files in the browser pane** — the path that started with “system file open works” is much closer to finished: drag upload, downloads, progress—so panes behave like a real desktop browser for upload/save, and Nexus files can move the same way. - **Honest residual** — we closed **chat parity as good enough**, not “every Nexus frame.” Secrets, some slash polish, and deeper protocol areas continue under a planning epic. Full official desktop client parity is a horizon. If you only remember one sentence: **TermSurf already put the web next to the shell; now it can put a real multi-channel BBS client there too—and we run a host you can log into.** ## What is Nexus? **Nexus** is a modern multi-channel BBS: chat, user messages, broadcasts, files, permissions, TLS—the stack documented for clients that speak its protocol. Upstream lives at **[github.com/zquestz/nexus](https://github.com/zquestz/nexus)** (server, client, trackers, docs). We are a **client** of that protocol, not a fork that reinvented the wire. The project’s author writes more widely at **[thoughts.greyh.at](https://thoughts.greyh.at/)**—engineering notes, OSS, the kind of terminal-adjacent work that sits next to why a BBS-in-a-pane is interesting at all. Credit where it belongs; Astrohacker’s job is the **TermSurf product surface** and **our** deployment of the server. We use path-pinned **`nexus-common`** for framing and types. We do not invent chat formats. ## Why host our own BBS Third-party servers are fine for exploration. Product work needs a host we control: deploy, passwords, operator accounts, smoke against a stable name. So we stood up **`nexus.astrohacker.com`**—digest-pinned **`nexusd`**, durable storage, public TLS edge. That work closed as **nexus host deploy**. Chat that only worked against someone else’s lag box was never going to be a product story. ## What `ahnexus` is **`ahnexus`** is the Astrohacker **Nexus TermSurf app**: Rust local server + React SPA, full pane, same install story as `ahcalc` / `ahhelp`. You connect (host, account, optional avatar). You get: - **Channels** — join, leave, send, members, topics (`/topic`) - **Actions** — `/me` as real `ChatAction::Me`, not cosmetic italics on normal text - **Discovery** — `/channels` lists the server catalog on **Console** (not only rooms you already joined) - **PMs** — `/msg nick text`, tabs at `/chat/pm/…` (no messaging yourself; the protocol forbids it) - **Broadcasts** — `/broadcast` when permitted; inbound `ServerBroadcast` as Console lines - **Console (`>_`)** — system lines, lists, broadcasts—not a place for plain room chat - **Avatar** — `--avatar /path/to.png` or pick/drop on Connect; sent on **Login** each session (BBS sessions do not magically keep last week’s face after a full disconnect) - **Files** — browse the user area; download/upload through the product path It is a **usable multi-channel client**, not a pixel clone of the official Nexus GUI, and not every protocol module (voice, news, full admin). ### How you try it Apple silicon, Astrohacker cask installed: ```sh ahnexus ``` Connect to **`nexus.astrohacker.com`** (or any Nexus host you use). Prefer the docs and in-app help (`ahhelp`) for flags and smoke paths—including `--avatar` for scripted login. Public TermSurf source stays on the usual track: **[github.com/astrohackerlabs/termsurf](https://github.com/astrohackerlabs/termsurf)**. Install remains Homebrew cask **`astrohacker`** when you want the packaged app. ## Files: finishing the pane browser story The [July 28 field note](/blog/2026-07-28-since-help-quit-file-open-and-password-plans) was honest: **system file open** worked; the rest of transfer was still coming. Since then, the transfer path moved a long way: drag-and-drop upload, multi-file cases, downloads to disk, progress feedback. That matters for ordinary websites **and** for Nexus file areas. A chat client that can list files but cannot save them is a museum exhibit. Password-manager and cloud vault work continue under their own epics. This post does **not** claim a vault launch. ## What we are not claiming - **Not** “full Nexus protocol done.” We closed **ahnexus chat parity** as good enough for multi-channel use: topics, list, `/me`, PMs, broadcasts, avatar. **Deferred** on purpose: secret channels, join/leave system lines in the transcript, full slash-table polish, every Console notice type. - **Not** English shell / model marketplace / wallet as available SKUs. - **Not** “we are a model lab.” - **Not** a soft-open of every Astrohacker cloud product. Further protocol work (secrets, voice, news, admin, deeper users/files, client hygiene) is planned under epic **Nexus protocol client parity**—issues and experiments, not a single big-bang rewrite. ## The line Monorepo product crates moved through the **late 0.1.9x** range into **0.1.103** in this window. Public cask version is whatever your tap last installed; upgrade when you want host, `ahnexus`, and file pins together. ## Install Apple silicon, Homebrew: ```sh brew tap astrohackerlabs/astrohacker brew trust astrohackerlabs/astrohacker brew install --cask astrohacker ``` App: **`/Applications/Astrohacker TermSurf.app`**. PATH tools include `ahterm`, `ahweb`, `ahsh`, `ahcalc`, `ahhelp`, **`ahnexus`**, and the Chromium helper as packaged. ## Close Localhost by port number was a small gift to a port-heavy day. **Nexus in a pane** is a larger one: the same layout that holds your agent and your frontend can hold multi-channel chat against a host we operate—or any Nexus BBS you choose. Upstream protocol and server: [github.com/zquestz/nexus](https://github.com/zquestz/nexus). Author’s writing: [thoughts.greyh.at](https://thoughts.greyh.at/). Our public TermSurf source: [github.com/astrohackerlabs/termsurf](https://github.com/astrohackerlabs/termsurf). Open TermSurf. Run **`ahnexus`**. Connect. Stay in the window. ]]> Ryan X. Charles https://astrohacker.com/blog/2026-07-29-port-shortcut-and-what-termsurf-is https://astrohacker.com/blog/2026-07-29-port-shortcut-and-what-termsurf-is Wed, 29 Jul 2026 12:54:59 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-28-since-help-quit-file-open-and-password-plans https://astrohacker.com/blog/2026-07-28-since-help-quit-file-open-and-password-plans Tue, 28 Jul 2026 12:23:37 GMT `, and click it. A real **macOS open panel** appears—owned by the app you launched, not a stuck helper sheet in the Dock. You pick a file. The page gets it. You try **upload folder** on a site that wants a tree; relative paths come through the way desktop Chromium would send them. That is not a marketing demo. It is the browser surface inside **Astrohacker TermSurf**, finally doing the first half of “use the web like a desktop browser in a pane.” On [July 27 we wrote about ahhelp, top-right quit, and shell discovery](/blog/2026-07-27-since-engine-pins-help-quit-and-shell-discovery)—product line roughly **0.1.84–0.1.87**. This post is what landed **after** that window: file **open** that works, an honest list of file transfer still missing, and a locked plan for a password manager that can talk **KeePass KDBX**—without pretending the cloud product is open for business. ## The short version - **Done — system file open.** Host-mediated **NSOpenPanel** for single file, multi-select, and **directory upload** (`webkitRelativePath`). Shipped on the product fork pins; monorepo crates **0.1.88**. - **In progress — the rest of file transfer.** Finder **drag upload**, **save** / download UX, and **drag download** to disk. Tracked separately; not claimed here. - **Planned — password manager.** Vault stays Astrohacker’s model. **KDBX 4.x** import/export is interop for common logins, not “we became KeePass.” Fill and save in Chromium, CLI, and TermSurf apps under **explicit consent**. - **Cloud — still building.** Account and vault groundwork continue under the hood. This is **not** a launch, soft-open, or “go create an account” post. - **Line — ~0.1.88.** Upgrade the cask when your tap has the chooser pins. If you only remember one sentence: **you can pick files and folders for upload in TermSurf Chromium now; downloads and drag are next; passwords are a real product plan, not a finished vault product.** ## File open that behaves like a browser Embedded Chromium in a terminal host does not magically own AppKit sheets. When the engine asked for a file dialog from the wrong process, you got the worst of both worlds: no usable panel, or a helper that looked like it owned the machine. The path that works: 1. The **engine** parks the chooser request. 2. **ahterm** (the real host app) runs **NSOpenPanel**. 3. Chosen paths (or cancel) come back over the **TermSurf** protocol. 4. The page sees ordinary file-input results. That is the same “host mediates, engine does not pretend to be the macOS app” idea as the rest of TermSurf—not a second file stack invented for marketing. ### Folders, not only single files Directory upload is not “attach one path and hope.” The host walks the tree **off the UI thread**, builds the multi-file list with relative paths, and finishes on the UI path the engine expects. We hit a hard fail when the walk ran on the UI thread (blocking asserts / abort). The fix is boring and correct: enumerate where blocking is allowed, then complete. What you can try after upgrade: any site with a file input, multi-select, or “upload folder.” If the open panel never appears, or a folder selection freezes the pane, say so—those are regressions against this stretch, not known “maybe later” gaps. ## What is not done yet Closing file **open** did not close file **transfer**. Still open work: - **Drag upload** — Finder → page drop target / file input in the pane. - **Downloads** — silent Downloads-folder placement *and* system **Save** when the product path needs a save panel, with ordinary completion feedback. - **Drag download** — page / browser surface → Finder (or the closest macOS behavior we can ship honestly). Until those land, vault **import** is “pick a file” capable; **export/save** and “drop the `.kdbx` on the page” are not the full desktop story. We will not paper over that with half-claims. ## Why this matters for passwords We opened a **Password Manager** epic with a locked product intent. The **vault** stays Astrohacker’s design: versioned per-secret ciphertext, multi-tenant cloud, unlock under the user’s keys. It is **not** “the product is a KeePass database.” **KeePassXC-class KDBX 4.x** is the **migration and interop** format—import and export common login fields (title, username, password, URL, notes), refuse attachments instead of silently dropping them on the crypto path, accept documented lossy group flatten when needed. Where people type passwords: - **TermSurf Chromium** — fill from vault and save into vault via the password-manager surface (engine hooks TBD by follow-on issues). - **CLI** — get/save after appropriate account / unlock. - **TermSurf apps** — may request a credential under **explicit user consent**, not ambient full vault dump to every pane. Passkeys and other non-file secrets may come later. KDBX is the on-ramp and off-ramp, not the ceiling. [Earlier cloud field notes](/blog/2026-07-26-since-hard-refresh-engines-shell-and-cloud) already named vault **groundwork** and a real **KDBX 4.x** package path. This post is the product plan that sits on top of that foundation—and the reason file open had to land first. Without a working chooser, “import a password file” is fiction. None of that means “password manager available now.” It means the next surfaces have a map: transfer the rest of the files, then wire fill/save and import/export where people actually live. ## Cloud: still in the shop TermSurf remains the interface you run **locally**. The company still builds a **cloud backend for the terminal**—accounts, keys, vault, later sync and more. That work is **in progress**. This post does **not** open a public onboarding tour, does **not** treat guest or signed-in cloud homes as ready, and does **not** ask you to live in a web account to use the terminal you already installed. When the cloud side is ready for ordinary use, we will say so in plain English. ## Upgrade Apple silicon, Homebrew: ```sh brew tap astrohackerlabs/astrohacker brew trust astrohackerlabs/astrohacker brew update brew upgrade --cask astrohacker ``` Install layout is unchanged: **Astrohacker TermSurf** in Applications; **`ahterm`**, **`ahweb`**, **`ahsh`**, **`ahcalc`**, **`ahhelp`** (and engine helpers) on `PATH`. File open needs a cask build that includes the **pinned** chooser tips—roughly the **0.1.88** monorepo line and whatever revision your tap publishes next. Full contract: [homebrew docs](https://astrohacker.com/docs) when you need paths and package names. ## Not this post - Not a re-tour of [ahhelp, quit, and banner discovery](/blog/2026-07-27-since-engine-pins-help-quit-and-shell-discovery)—those already shipped in the previous field notes. - Not the [economic singularity vision essay](/blog/2026-07-27-our-vision-for-the-economic-singularity)—direction, not a ship list. - Not “downloads and drag work today.” - Not “password manager / KeePass sync available now.” - Not a soft-launch map of cloud accounts or OAuth-from-the-CLI as public product. - Not “AI marketplace available now.” ## One more thing Keep the cask current. The last stretch taught the product how to explain itself and how to leave cleanly. This stretch teaches the embedded browser how to **take files from the Mac** the way users already expect. Downloads and drag close the loop. The password epic is where that loop pays off for secrets—import, export, fill, save—without turning the vault into someone else’s file format. If open panels still fail after upgrade, or a folder upload aborts the engine, report it. The point of shipping every few days is not the version number; it is whether a pane still behaves like a tool you trust with a real workday. ]]> Ryan X. Charles https://astrohacker.com/blog/2026-07-27-since-engine-pins-help-quit-and-shell-discovery https://astrohacker.com/blog/2026-07-27-since-engine-pins-help-quit-and-shell-discovery Mon, 27 Jul 2026 11:45:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-27-our-vision-for-the-economic-singularity https://astrohacker.com/blog/2026-07-27-our-vision-for-the-economic-singularity Mon, 27 Jul 2026 10:15:52 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-26-since-hard-refresh-engines-shell-and-cloud https://astrohacker.com/blog/2026-07-26-since-hard-refresh-engines-shell-and-cloud Sun, 26 Jul 2026 20:06:30 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-22-hard-refresh-flick-scroll-and-video https://astrohacker.com/blog/2026-07-22-hard-refresh-flick-scroll-and-video Wed, 22 Jul 2026 21:30:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-21-chromium-only-for-now https://astrohacker.com/blog/2026-07-21-chromium-only-for-now Tue, 21 Jul 2026 23:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-20-astrohacker-0-1-60 https://astrohacker.com/blog/2026-07-20-astrohacker-0-1-60 Mon, 20 Jul 2026 22:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-19-how-termsurf-talks https://astrohacker.com/blog/2026-07-19-how-termsurf-talks Sun, 19 Jul 2026 18:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-18-astrohacker-0-1-47 https://astrohacker.com/blog/2026-07-18-astrohacker-0-1-47 Sat, 18 Jul 2026 22:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-17-astrohacker-0-1-37 https://astrohacker.com/blog/2026-07-17-astrohacker-0-1-37 Fri, 17 Jul 2026 22:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-17-since-astrohacker-0-1-17 https://astrohacker.com/blog/2026-07-17-since-astrohacker-0-1-17 Fri, 17 Jul 2026 20:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-15-how-to-get-ai-solving-problems-for-you-while-you-sleep https://astrohacker.com/blog/2026-07-15-how-to-get-ai-solving-problems-for-you-while-you-sleep Wed, 15 Jul 2026 18:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-14-why-ghostty-is-the-greatest-terminal https://astrohacker.com/blog/2026-07-14-why-ghostty-is-the-greatest-terminal Tue, 14 Jul 2026 16:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-13-astrohacker-0-1-17 https://astrohacker.com/blog/2026-07-13-astrohacker-0-1-17 Mon, 13 Jul 2026 12:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-12-why-gecko-is-the-hard-one https://astrohacker.com/blog/2026-07-12-why-gecko-is-the-hard-one Sun, 12 Jul 2026 16:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-07-11-unifying-under-astrohacker https://astrohacker.com/blog/2026-07-11-unifying-under-astrohacker Sat, 11 Jul 2026 18:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-06-01-building-software-while-you-sleep https://astrohacker.com/blog/2026-06-01-building-software-while-you-sleep Mon, 01 Jun 2026 12:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-05-18-earthbucks-2-network-plan https://astrohacker.com/blog/2026-05-18-earthbucks-2-network-plan Mon, 18 May 2026 12:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-05-04-astrohacker-begins-earthbucks-2-0 https://astrohacker.com/blog/2026-05-04-astrohacker-begins-earthbucks-2-0 Mon, 04 May 2026 12:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-04-27-keypears-hybrid-post-quantum https://astrohacker.com/blog/2026-04-27-keypears-hybrid-post-quantum Mon, 27 Apr 2026 12:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-04-24-introducing-rss-anyway https://astrohacker.com/blog/2026-04-24-introducing-rss-anyway Fri, 24 Apr 2026 12:00:00 GMT Ryan X. Charles https://astrohacker.com/blog/2026-04-13-introducing-astrohacker https://astrohacker.com/blog/2026-04-13-introducing-astrohacker Mon, 13 Apr 2026 12:00:00 GMT Ryan X. Charles