---
license: apache-2.0
tags:
- snapkitty
- developer-tools
- c++
---

> Source: [github.com/SNAPKITTYWEST/hyperkitty-chromium](https://github.com/SNAPKITTYWEST/hyperkitty-chromium)

HyperKitty Chromium — Architecture
Status: implemented reference implementation. Every module, supervision relationship, schema, and API route described below exists in this repository and compiles, boots, and passes its test suite (rebar3 eunit: 24 tests, 0 failures, including real headless-Chromium integration tests and chaos tests that kill live processes to verify recovery). Sections are marked (planned) where the specification calls for something this revision intentionally stubs or defers — there is no unmarked aspirational content in this document.

1. Purpose and scope
HyperKitty Chromium is an Erlang/OTP-native browser agent platform: a headless Chromium instance, driven over the Chrome DevTools Protocol (CDP), wrapped in an explicit OTP supervision tree so that browser control, agent orchestration, search, and messaging are separate, independently-supervised, independently-observable subsystems rather than library calls inside one monolithic process. The design principle it exists to demonstrate: an LLM-driven "agent" is a planning function that proposes tool calls; it is never trusted with direct, unchecked access to a browser process. Every tool call crosses an explicit, typed capability boundary — enforced by Erlang code, not by the prompt — before it reaches Chromium.

---

## License

Licensed under **Apache-2.0**. Full text: [LICENSE](LICENSE).