hive.browser-automation
Required before any hive-browser CLI command. The browser is driven from the terminal by running `hive-browser <command> ... --json` via terminal_exec — not via MCP tools. Teaches the browser lifecycle rules (the bridge attaches to the USER'S running Chrome — never kill or launch browser processes; timeouts are transport issues, not crashes), the screenshot + coordinate workflow (hive-browser interact with a fractional coordinate) that reaches shadow-DOM inputs selectors can't see, the viewport-
Оригинален текст · няма потвърден превод на българскиПърво прочетете инструкцията.
Файлът се зарежда от посочения източник само по ваше действие. Можете да го прочетете тук, да го копирате или да го запазите като .md.
GitHub хранилище- Звезди на репото
- 11 068
- Лиценз
- Apache-2.0
- Последна проверка на записа
- 20.09.2026 г.
Добавете в своя инструмент.
Командата отваря избора на skills от репозитория. Прочетете файла и условията на автора преди изпълнение.
npx skills add aden-hive/hiveСтраницата копира текст. Не инсталира и не изпълнява нищо на устройството ви.
Откъс от SKILL.md
Началото на файла на автора, без превод.
GCU Browser Automation
All GCU browser automation drives a real Chrome instance through the Beeline extension and Chrome DevTools Protocol (CDP). You drive it from the terminal: every command is hive-browser <command> ... --json, run through terminal_exec. Always pass --json so the result is machine-readable. That means clicks, keystrokes, and screenshots are processed by the actual browser's native hit testing, focus, and layout engines — not a synthetic event layer. Understanding this unlocks strategies that make hard sites easy.
Browser lifecycle & recovery — read this before "fixing" anything
The bridge attaches to the user's already-running Chrome via the extension. The browser is not yours: it holds the user's logged-in sessions and other agents' work, and the runtime — not you — owns the connection to it. Consequences:
- There is nothing to "start." If no browser is connected,
hive-browser setup --jsontells you and gives the user install steps. Launching Chrome yourself (anygoogle-chrome/chromiumcommand,--remote-debugging-port,--user-data-dir, headless flags) is forbidden and blocked — it opens a browser the bridge can't see, often under the wrong profile. - There is no situation where killing the browser helps. Never use terminal tools to
kill/pkill/killallChrome, the bridge, or gcu processes. These commands are blocked, and attempting them breaks every agent sharing the connection. The same applies to the Hive desktop app andbridge_host. - A timeout is NOT a stuck browser. All
hive-browsercommands share one transport across all agents; one slow call (a heavyhive-browser evaluateon a big page) can make YOUR calls time out while the browser is perfectly healthy. The timeout message tells you whether the server passed its liveness check and whether recovery is already running — believe it. - Allowed recovery, in order: (1) wait ~30s and retry ONCE, with a smaller/simpler request — e.g. split a page-wide
hive-browser evaluatesweep into chunked queries; (2) close YOUR OWN tabs withhive-browser tab close <T> --jsonand reopen; (3) report the failure (report_to_parentor your reporting channel) and move on to work that doesn't need the browser. Escalate to the user; never to the process table. - Keep heavy
hive-browser evaluatescripts cheap: avoidinnerTextover thousands of nodes (each read forces layout). PrefertextContent, scope the selector, and paginate the sw