ASTROHACKER

Since Engine Pins: Help in a Pane, Quit in Chrome, and a Shell That Points You

July 27, 2026 · Ryan X. Charles

You open Astrohacker TermSurf, land in ahsh, and the banner does not only mention Shift+Tab. It tells you to type ahweb, type ahhelp, and type ah then Tab. You run ahhelp, and a full-pane cheatsheet opens with the same GlyphRain dark as the calculator—host keybinds, browser modes, shell dialects, and a short note on what the TermSurf protocol actually is. You flip to ahweb, finish a page, and hit a real × in the top-right of the chrome instead of hunting :q.

None of that is a new architecture. It is the product explaining itself and closing cleanly after a week of fresher engines and cloud groundwork.

On July 26 we wrote about engine pins, shell tips, and the cloud behind TermSurf—Chromium 150, Ghostty on Zig 0.16, quieter ahweb chrome, Nu/Reedline on main, roughly 0.1.79–0.1.83, plus honest cloud progress. This post is what landed after that window for day-to-day use.

The short version

  • ahhelp — new TermSurf app: in-pane product help at /ahterm, /ahweb, /ahsh (tabs are real routes). Host defaults and keybinds, ahweb modes, ahsh Nu↔zsh, copy-paste config, Caps Lock tip, and a plain sentence about webview overlays (why TermSurf is not stock Ghostty).
  • ahsh banner — discovery lines for ahweb, ahhelp, and ah + Tab; command tokens painted cyan like Nu’s default external-command style.
  • ahweb — top-right quit (×) on the nav chrome (width matched to the rest of the strip). :q / Ctrl+C still work.
  • ahcalc — release packaging actually ships the SPA build/client so the cask calc is not empty chrome.
  • Readability — shared muted text token lifted so secondary copy is not comment-gray across help, calc, and the webapp.
  • Line — monorepo product crates roughly 0.1.84–0.1.87. Upgrade the cask when your tap has the bits you care about.

If you only remember one sentence: the stack got fresher last post; this stretch makes TermSurf self-explaining and easier to leave without memorizing commands.

ahhelp — docs that live in a pane

ahhelp is a first-class TermSurf CLI, same family as ahcalc: one binary, full-pane web UI, close with × or Esc. It is not a link out to the marketing site. It is product memory for people who already installed the terminal.

The cheatsheet is three routes, not a single scroll dump:

  • /ahterm (default) — what TermSurf is, host keybinds, stock defaults, config path, pasteable product defaults, Caps Lock → Control, Ghostty docs via ahweb ghostty.org.
  • /ahweb — modes (Browse / Control / Edit / Command), navigation keys, quit paths.
  • /ahsh — Nu vs zsh, Shift+Tab, SHANNON_MODE, sample syntax, and ahweb pointers to upstream Nu and zsh docs.

The What is ahterm? lead now says the quiet part out loud: TermSurf is Ghostty-based plus the TermSurf protocol—CLI apps can load real browser engines as webview overlays inside terminal panes. That overlay model is why the product exists and what stock Ghostty does not do. Host splits, shell, and pane apps sit under that fact instead of pretending we only re-skinned a terminal.

Visual chrome matches the rest of the suite: brand header, glass cards, Glyph Rain. Muted body text uses the shared brighter secondary token so the long copy is readable.

Shell intro that names the suite

ahsh already said Shift+Tab toggles Nu and zsh. New users still need a map of the CLIs on PATH.

Full and short banners now include, after the mode line:

  • Type ahweb to browse the web.
  • Type ahhelp for quick help.
  • Type ah then Tab to see more commands.

The command tokens use the same cyan as Nu’s default shape_external so they look like first-token externals on a normal prompt—not green “success” noise.

ahweb — quit without the command bar

Browse and Control still own most of the story. The missing piece for muscle memory from every other app was a visible quit control.

ahweb now has a × on the top-right of the chrome, sized like the rest of the nav strip. Prefer :q or Ctrl+C if you live in the command bar; the button is for everyone else (and for the days you forget the colon).

ahcalc packaging (one honest fix)

ahcalc was already the scientific calculator pane. A release-stage gap meant some packaged builds could miss the SPA client tree. The stage now ships build/client with the binary so Homebrew calc matches what developers run from a full tree. If calc looked broken after install, upgrade and try again—not a new product, a payload that finally matches the app.

Upgrade

Apple silicon, Homebrew:

brew tap astrohackerlabs/astrohacker
brew trust astrohackerlabs/astrohacker
brew update
brew upgrade --cask astrohacker

Install layout stays the same: Astrohacker TermSurf in Applications; ahterm, ahweb, ahsh, ahcalc, ahhelp (and engine helpers) on PATH. Full contract: homebrew docs when you need paths and package names.

Not this post

  • Not the economic singularity vision essay—that is direction, not a ship list.
  • Not a soft-launch map of cloud accounts, OAuth-from-the-CLI, or bookmarks sync.
  • Not a tmux multi-webview architecture diary (we assessed it; it is not a user feature today).
  • Not “AI marketplace available now.”

One more thing

Keep the cask current. The last post refreshed engines and shell pins under your feet. This stretch puts help, discovery, and quit where your hands already are—pane, banner, chrome.

If ahhelp is missing a binding you use every day, or the banner still sends you nowhere useful, say so. The point of shipping every few days is not the version number; it is whether a new pane still feels like a tool you can learn without leaving the terminal.

← Back to blog