use-my-browser

# Use My Browser

Operate the user's real Chrome browser through Tampermonkey script injection. The agent runs JavaScript directly in the page context — sharing all cookies, sessions, and login state.

## Setup

```bash
openclaw plugins install openclaw-tmwd --registry https://registry.npmjs.org
```

Then install the [Tampermonkey userscript](https://raw.githubusercontent.com/lsdefine/pc-agent-loop/main/assets/ljq_web_driver.user.js) in Chrome. Green indicator at bottom-right = connected.

## Tools

| Tool | Purpose |
|------|---------|
| `tmwd_status` | Check connection, list connected tabs |
| `tmwd_switch` | Switch to tab matching URL pattern |
| `tmwd_navigate` | Navigate current tab to URL |
| `tmwd_newtab` | Open new tab |
| `tmwd_text` | Get visible text of current page |
| `tmwd_elements` | List interactive elements (buttons, links, inputs) |
| `tmwd_scan` | Get simplified HTML |
| `tmwd_exec` | Execute JavaScript in page context |

## Workflow

### Read a page

```
tmwd_status()                          # Verify connection
tmwd_switch(pattern="github.com")      # Switch to target tab
tmwd_text(max_chars=5000)              # Get page content
```

### Navigate to URL

```
tmwd_navigate(url="https://example.com")
tmwd_text()
```

### Click / fill / interact

```
tmwd_exec(code="document.querySelector('#submit').click()")

tmwd_exec(code="var e=document.querySelector('#email'); e.value='user@example.com'; e.dispatchEvent(new Event('input',{bubbles:true}))")
```

### Extract data

```
tmwd_exec(code="return document.querySelector('.content').innerText")

tmwd_exec(code="return Array.from(document.querySelectorAll('h2')).map(e=>e.textContent)")
```

### Read table data

```
tmwd_exec(code="var rows=document.querySelectorAll('table tr'); var d=[]; rows.forEach(function(r){var c=[]; r.querySelectorAll('td,th').forEach(function(e){c.push(e.innerText.trim())}); if(c.length) d.push(c)}); return d")
```

### Click by text match

```
tmwd_exec(code="var btns=document.qu...