📚 Hypagon Gateway — Documentation

The local browser for AI agents.

This is the curated documentation set published on GitHub Pages. Internal field notes, plans and handoffs are intentionally not published here; links to them go back to the repository.

Start

• Overview — what Hypagon Gateway is and how the pieces fit together.
• Building & packaging — installers, CI, signing, auto-update and release policy.
• Packaging notes — distribution-specific notes.
• Changelog — every shipped release.

Developer documentation

• Developer guide — the standard OKF v0.2 bundle for API and integration work.
• Connect an MCP client — hb-browser, hb-rest, bundled runtime and environment variables.
• Agent skills — install the hb-browser and hb-wrap skills from GitHub.
• Browser MCP API — tool groups, resources and call shape.
• REST MCP API — meta-tools, generated tools and result shapes.
• Remote MCP gateway (experimental) — Streamable HTTP gateway, bearer/OAuth modes, and named Cloudflare Tunnel. Third-party client support is experimental; Gemini Connected Apps is known to be flaky.
• Development logs MCP — local-only log access for development.
• Wrapper format and recipe format.

Hypagon Browser

• Architecture — system maps, call paths and subsystem findings.
• Control layer — targeting, consent, human takeover and input pacing.
• Shadow DOM & frames — what the browser can see and click.
• Shadow Walk — sealed-content discovery and the tiered risk levers.
• Research mode — isolated research sessions, proxies and challenge backoff.
• Cortex embeddings — embedding providers and local recall.
• Decision models — the optional decide / drive layer.
• JEV page compaction — the optional surface index that keeps large pages out of context.
• Settings layout — the shared panes, field grids and cards used by every settings tab.

Hypagon REST

• Hypagon REST man page — wrappers, recipes, credentials, pagination and the MCP surface.
• anyapi-to-mcp integration — which core runs a wrapper, the per-wrapper gate, and how to roll back.
• Legacy Kuang Wrap link — compatibility stub for existing links.

Reference

• Concept and lore — design philosophy and the original inspiration.
• Browser navigation playbook
• CAPTCHA and anti-bot strategies
• Primitives and workflows
• Selector and set-of-marks recipes

Compatibility

New MCP configurations use hb-browser and hb-rest. The legacy kuang and kuang-wrap labels, KUANG_* environment variables and existing wrapper files remain supported.