Astrohacker TermSurf

Astrohacker TermSurf is a desktop host with a real browser in the pane. Run ahweb, open a URL, and the page appears alongside shells and other terminal workflows.

This public repository contains the open source client material synced from the private Astrohacker monorepo for source releases. It includes:

• assets/ — TermSurf mark SVG and icon masters (termsurf-icon.svg, termsurf-14-*.png).
• docs/ — product docs and public legal/records.
• scripts/ — public build/install helpers and smoke scripts. and protocol/native support code.
• patches/ — fork patch archives and reconstruction notes for Chromium,

Large upstream fork checkouts and build outputs are not committed here. Use the patch records under patches/ to reconstruct local engine workspaces when developing browser integrations.

Install

The Astrohacker Homebrew cask targets Apple silicon macOS and installs into /Applications as Astrohacker TermSurf.app:

brew tap astrohackerlabs/astrohacker
brew trust astrohackerlabs/astrohacker
brew install --cask astrohacker

To upgrade:

brew update
brew upgrade --cask astrohacker

Build

Development builds require Xcode, Zig, Rust, Bun, Chromium's depot_tools, and

brew install zig
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
curl -fsSL https://bun.sh/install | bash

Prepare local engine workspaces from the recorded patch archives, then build the client components:

./scripts/build.sh chromium
./scripts/build.sh ahweb
./scripts/build.sh ahterm

For a release-style local build:

./scripts/build.sh all --release

The app bundle is written to:

forks/ghostty/macos/build/Release/Astrohacker TermSurf.app

Run

During development, launch the Ghostty-based frontend from the reconstructed Ghostty workspace:

cd forks/ghostty
zig build -Demit-macos-app=false
cd macos
./build.nu --configuration Debug --action build

Inside Astrohacker TermSurf, run the debug ahweb binary and point it at a local engine build:

./rust/target/debug/ahweb \
  --browser ./forks/chromium/src/out/Default/ah-chromiumd \
  https://example.com

License

See LICENSE, NOTICE, and TRADEMARKS.md.