Docs

These pages are for people who want to use the TermSurf API: build a TermSurf app, an engine helper, or a terminal host that speaks the protocol. End users who only need the product should install Astrohacker TermSurf and start there.

Astrohacker TermSurf is the desktop product. TermSurf is the protocol and app-platform language (`termsurf.proto`, local sockets, pane ↔ tab work).

• TermSurf appBuild a full-pane client (like ahcalc or ahhelp) that opens work on a pane through the host.
• Engine helperImplement a browser-engine process that owns tabs and surfaces and speaks host↔engine messages.
• Terminal hostImplement a host that owns panes, compositing, and routing between clients and engines.

Start with the TermSurf protocol overview for the multi-process model and how the pieces fit. Deep message and wire reference land in later docs work; this scaffold already reserves those paths.

You do not need a from-source build to explore the shipping host. Install on Apple silicon with Homebrew: