PHPackages                             coquibot/coqui-toolkit-browser - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. coquibot/coqui-toolkit-browser

ActiveLibrary[Utility & Helpers](/categories/utility)

coquibot/coqui-toolkit-browser
==============================

Browser automation toolkit for Coqui — web browsing via playwright-cli

v0.1.1(1mo ago)01↓100%MITPHPPHP ^8.4CI passing

Since Feb 23Pushed 1mo agoCompare

[ Source](https://github.com/carmelosantana/coqui-toolkit-browser)[ Packagist](https://packagist.org/packages/coquibot/coqui-toolkit-browser)[ RSS](/packages/coquibot-coqui-toolkit-browser/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (4)Used By (0)

Coqui Browser Toolkit
=====================

[](#coqui-browser-toolkit)

Browser automation toolkit for [Coqui](https://github.com/AgentCoqui/coqui). Wraps [playwright-cli](https://github.com/anthropics/playwright-cli) to give agents full web browsing capabilities including navigation, page interaction, screenshots, cookie/storage management, and session control.

Requirements
------------

[](#requirements)

- PHP 8.4+
- Node.js 18+ and npm (for playwright-cli installation)

Installation
------------

[](#installation)

```
composer require coquibot/coqui-toolkit-browser
```

When installed alongside Coqui, the toolkit is **auto-discovered** via Composer's `extra.php-agents.toolkits` -- no manual registration needed.

On first use, the agent will automatically install playwright-cli and Chromium into `.workspace/browser/` via the `browser_session setup` action. No manual Node.js setup is needed.

Tools Provided
--------------

[](#tools-provided)

### `browser`

[](#browser)

Navigate web pages and interact with elements.

ParameterTypeRequiredDescription`action`enumYes`open`, `click`, `dblclick`, `fill`, `type`, `press`, `keydown`, `keyup`, `hover`, `select`, `check`, `uncheck`, `scroll`, `drag`, `upload`, `back`, `forward`, `reload`, `eval`, `resize`, `wait`, `close``url`stringNoURL for `open` action`ref`stringNoElement ref from snapshot (for interaction actions)`value`stringNoValue for `fill`, `type`, `select`, `eval``key`stringNoKey for `press`, `keydown`, `keyup` (e.g. "Enter", "Tab")`session`stringNoOverride session name`headed`boolNoShow visible browser (default: headless)`browser_engine`enumNo`chromium`, `firefox`, `webkit``persistent`boolNoUse persistent browser profile### `browser_capture`

[](#browser_capture)

Capture page state as snapshots, screenshots, or PDFs.

ParameterTypeRequiredDescription`action`enumYes`snapshot`, `screenshot`, `pdf``ref`stringNoTarget element ref`filename`stringNoOutput filename (auto-generated if omitted)`session`stringNoOverride session name### `browser_storage`

[](#browser_storage)

Manage cookies, localStorage, sessionStorage, and persist browser state.

ParameterTypeRequiredDescription`action`enumYes`cookie_get`, `cookie_get_all`, `cookie_set`, `cookie_delete`, `cookie_clear`, `localstorage_get`, `localstorage_set`, `localstorage_delete`, `localstorage_clear`, `sessionstorage_get`, `sessionstorage_set`, `sessionstorage_delete`, `sessionstorage_clear`, `state_save`, `state_load``name`stringNoCookie/storage key name`value`stringNoValue for set operations`domain`stringNoCookie domain`filename`stringNoState filename for save/load`session`stringNoOverride session name### `browser_session`

[](#browser_session)

Manage browser sessions and playwright-cli installation.

ParameterTypeRequiredDescription`action`enumYes`setup`, `setup_deps`, `status`, `list`, `close`, `close_all`, `kill_all`, `delete_data``session`stringNoTarget session for close/delete\_dataSession Management
------------------

[](#session-management)

Sessions are auto-scoped to the workspace using a deterministic hash (`coqui-{md5_8chars}`). All four tools share the same session by default, so cookies and state persist across tool calls.

Override the session name with the `session` parameter on any tool to manage multiple independent browser contexts.

Agent Workflow
--------------

[](#agent-workflow)

1. `browser_session` action `setup` -- install playwright-cli (first time only)
2. `browser` action `open` -- navigate to a URL
3. `browser_capture` action `snapshot` -- get the accessibility tree with element refs
4. `browser` action `click`/`fill`/`type` -- interact using refs from the snapshot
5. `browser_capture` action `screenshot` -- capture visual output
6. `browser_session` action `close` -- clean up when done

Standalone Usage
----------------

[](#standalone-usage)

```