ASTROHACKER

Astrohacker TermSurf v0.1.90: Open Localhost by Port Number

July 29, 2026 · Ryan X. Charles

Your frontend is on 3456. Your API is on 8787. The throwaway fixture server from five minutes ago is on whatever free port the tool printed and you already forgot the host half of the string.

You do not want to type localhost again. You want the number.

In Astrohacker TermSurf, ahweb now treats a bare port as a local server: ahweb 3456 opens http://localhost:3456. Same idea if you are already in the browser pane—put 3456 in the URL bar and go.

The tax you stop paying

Local development is a parade of short-lived HTTP servers. Frameworks, dashboards, OAuth callbacks, docs previews, calculators, mock APIs—almost all of them are “something on this machine, this port.”

The full URL is honest. It is also noise. You already know the host is localhost. The only thing that changes all day is the port. Re-typing http://localhost:—or even localhost:—is pure tax between “server is up” and “I can see it.”

Chrome and Safari do not care how you feel about that tax. They live in another space. TermSurf lives next to the shell that started the server. The browser should meet you at the same level of shorthand you already use when you read a log line that says listening on 5173.

What you do now

From the shell:

ahweb 3456

From the URL bar (Control mode, edit the location, submit):

3456

Both mean: open HTTP on this Mac, that port. No host. No scheme typing ceremony for the common case.

You still use full URLs when you need them—https://example.com, localhost:3456 with the host spelled out, real paths. The port shortcut does not replace the web. It removes friction from the case you hit most while building.

Why this is more useful than it looks

A small shortcut is only small if you use it once. Agentic and terminal-first days are port days:

  • You spin a UI, open it, kill it, spin another.
  • An agent prints a local URL; you only need the number.
  • You keep two services up and jump between ports without leaving the terminal window.
  • You demo a pane layout: shell in one, local app in another—handoff is a four-digit gesture, not a mini-essay in the address bar.

TermSurf’s job is to keep computer and web in one place. If opening the local web still feels like “go use a different app and type a hostname,” the product is fighting itself. Bare ports are the product agreeing with how local servers actually work.

The day

Start the frontend. Type the port. Pane loads. Hit the backend health route on another port. Flip back. Stay in ahterm. Keep the coding agent where it is. Do not Cmd-Tab to a browser profile that still has your bank tab from last night.

That loop shows up every time something listens. The shortcut only pays off because the browser already lives next to the shell—which is the product.

Astrohacker TermSurf

The Agentic Hacker’s Terminal. The installable product is Astrohacker TermSurf.

It is a terminal emulator with a webview overlay protocol: real browser engines can run inside terminal panes, not only as a separate OS browser. You browse the web, hack the web, and show real GUIs next to the shell—same window, same session, same muscle memory for splits and focus.

Designed for agentic engineers who want maximum power over their own computer and the web—not a toy embedded WebView, and not four consumer SKUs pretending to be one product.

Three layers you actually use

  • Terminal — Ghostty-class host (ahterm). Panes, tabs, serious terminal behavior.
  • Browser — Chromium-backed panes (ahweb). Real engine, real pages, in the layout you already split for code and agents.
  • Shell — Nu-powered product shell (ahsh), with traditional shell escape hatches as the product documents them.

Under the hood that maps to engines and tools people already trust (Ghostty, Chromium, Nushell). You install one desktop package—Homebrew cask astrohacker—not a shopping cart of peer apps. The CLIs are components of TermSurf, not separate marketed products.

What ships vs what does not

Ships today (Apple silicon macOS): the desktop terminal, browser panes, shell, and the helpers that make panes work. Traditional terminal workflows work without an Astrohacker account.

Not available as “use it now” product (direction only until we say otherwise): English default AI shell, model marketplace, hosted models as a public SKU, free-credit soft launch, wallet / Economy commerce surfaces. We build toward an agent-native future; we do not fake the inventory.

The cloud side of the company is in progress. You do not need a web account to install TermSurf and work offline. When cloud is ready for ordinary use, we will say so in plain English—not as a scavenger hunt.

Install

Apple silicon, Homebrew:

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

App: Astrohacker TermSurf in Applications. On PATH: ahterm, ahweb, ahsh, and friends. Need a cheatsheet after install? Type ahhelp inside TermSurf.

Type the port. Keep the rest of the day in the same window.

← Back to blog