docs: Aside first, gstack browser fallback

README, BROWSER.md, docs/, CONTRIBUTING, CLAUDE.md, ARCHITECTURE, AGENTS.md, TODOS and the root router describe the one product story: Aside is the browser gstack drives first; the bundled headless browser is the automatic fallback (Linux, Windows, app closed) where cookie import, GStack Browser, pair-agent and browser-skills still apply.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
Sina
2026-09-05 16:48:38 -04:00
co-authored by Claude Fable 5.1
parent 886217894f
commit f7d68c253e
16 changed files with 631 additions and 128 deletions
+2
View File
@@ -1,5 +1,7 @@
# Browser / sidebar / server internals
> **Scope:** this is the internals reference for gstack's own browser engine — the `browse` daemon, GStack Browser, the sidebar extension. That engine is the automatic **fallback** when the Aside browser is not installed or not running (Linux, Windows, a closed Aside app); Aside is what every skill drives first. The Aside contract lives in `scripts/resolvers/aside.ts` and [BROWSER.md](../BROWSER.md).
Moved verbatim from CLAUDE.md (token-load reduction). These are the
load-bearing invariants for `browse/src/server.ts`, the Chrome extension,
the sidebar PTY, SSE endpoints, CDP sessions, and the sidebar security