☰
ASTROHACKER

TermSurf

The app you open every day—browser engines in panes beside your shell, multiple profiles per engine.

What you can do

Keep shell work and the web in one window. Run Chromium, WebKit, and Ladybird as panes. Use multiple profiles per engine. You do not need a separate browser stack for every project.

The host is built on Ghostty. Astrohacker adds multi-engine panes, profiles, and the TermSurf protocol so tools can drive those panes. For the full Ghostty terminal feature set, read Ghostty’s own documentation.

Astrohacker-specific UI: panes can show borders (and related chrome such as title display and padding). Active browser and shell panes stay readable in multi-pane layouts.

Typical day

  1. Open Astrohacker TermSurf and your usual shell panes.
  2. Open a web pane for the app you build. Open more engines or profiles side by side when you need them.
  3. Drive pages from the shell when you want (Web). Keep editing and shells in the same window.

Installation

Install with the Homebrew cask. The app lands as Astrohacker TermSurf.app under /Applications. The launcher is ahterm. Companion binaries land on the Homebrew PATH.

Install Astrohacker TermSurf

Homebrew cask · Apple silicon macOS

Select

brewtapastrohackerlabs/astrohacker

brewtrustastrohackerlabs/astrohacker

brewinstall--caskastrohacker

Then open Astrohacker TermSurf.app from Applications.

Configuration

Paths follow the XDG Base Directory Specification. Product folder: astrohacker/terminal/.

VariableDefault baseHost path
XDG_CONFIG_HOME~/.config…/astrohacker/terminal/
XDG_DATA_HOME~/.local/share…/astrohacker/terminal/
XDG_STATE_HOME~/.local/state…/astrohacker/terminal/
XDG_CACHE_HOME~/.cache…/astrohacker/terminal/
  • Config — config (main settings), themes/
  • Data — chromium-profiles/<profile>/, webkit-profiles/<profile>/, fallback browser-profiles/<profile>/
  • State — logs (e.g. chromium-server.log), crash reports, SSH cache

More information