thinkbrowse-clilisted
Install: claude install-skill dundas/thinkrun
# ThinkBrowse CLI
Control real browsers from Claude Code using the `thinkbrowse` CLI. Two modes:
- **Local mode** — drives your actual Chrome via the ThinkBrowse extension (free, auth cookies available)
- **Cloud mode** — provisions isolated Playwright browsers on Fly.io (credits, headless, stealth)
## Quick Start
```bash
# Local mode — list tabs, attach, navigate, observe
thinkbrowse tabs
thinkbrowse attach <tabId>
thinkbrowse navigate "https://example.com"
thinkbrowse snapshot # accessibility tree (best for AI)
thinkbrowse screenshot --output /tmp/page.png
# Cloud mode — create session, navigate, observe, clean up
thinkbrowse cloud start "https://example.com"
thinkbrowse snapshot
thinkbrowse screenshot --output /tmp/page.png
thinkbrowse cloud stop --all
```
## Mode Detection
| Signal | Mode |
|--------|------|
| Bridge running + extension connected | Local |
| `THINKBROWSE_API_KEY` set | Cloud |
| Neither | Error |
Priority: `--tab` flag > `THINKBROWSE_TAB_ID` env > working-location.json > API key (cloud).
## Top 5 Patterns
### 1. Navigate and Observe
```bash
thinkbrowse navigate "https://example.com"
sleep 2 # Wait for page load + CSRF tokens
thinkbrowse snapshot # Read structure before interacting
thinkbrowse screenshot --output /tmp/page.png
# Then use Read tool on /tmp/page.png to view it
```
### 2. Click by Text Content (RECOMMENDED)
Direct CSS selectors often fail when elements lack uni