matthewwong525/WongStack / .agents/plugins/browser
browser
VerifiedThe person's own browser, for errands.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 4.4 KB |
| SKILL.md | skill md | 3.6 KB |
| VERSION | other | 6 B |
| addon/background.js | script | 1.1 KB |
| addon/check.svg | other | 591 B |
| addon/manifest.json | config | 462 B |
| references/browser-proxy.md | markdown | 5.2 KB |
| references/browser-window.md | markdown | 6.4 KB |
| references/browsing.md | markdown | 18.6 KB |
| references/login-codes.md | markdown | 5.6 KB |
| references/password-manager.md | markdown | 8.3 KB |
| references/setup.md | markdown | 6.4 KB |
| scripts/addons.mjs | script | 26.3 KB |
| scripts/browse.mjs | script | 53.5 KB |
| scripts/browser-server.mjs | script | 50.8 KB |
| scripts/connect-browser.mjs | script | 17.3 KB |
| scripts/forwarder.mjs | script | 14.5 KB |
| scripts/launch-config.py | script | 7.4 KB |
| scripts/lib/cli.mjs | script | 1.2 KB |
| scripts/lib/env.mjs | script | 614 B |
| scripts/lib/primary-root.mjsexecutable | script | 1.9 KB |
| scripts/lib/profile.mjs | script | 1.4 KB |
| scripts/login-move.mjs | script | 4.0 KB |
| scripts/mask-keys.mjs | script | 2.9 KB |
| scripts/proxy-lines.mjs | script | 4.7 KB |
| scripts/refs.mjs | script | 5.4 KB |
SKILL.md
View on GitHub---
name: browser
description: The person's own browser, for errands.
hidden: true
disable-model-invocation: true
---
# browser
`scripts/browse.mjs` drives Camoufox, the browser the agent uses websites in as the person. [Browsing](references/browsing.md) owns when and how to run it:
- `open`, `snapshot`, `click`, `type`, `press`, `select`, `get`, and `screenshot` work this task's own tab.
- A click runs at once, also during another chat's turn. `BROWSE_CLICK=queued` comes only from an older running browser: run `wait-click` in the background and take no other step on that page until it ends. `BROWSE_FRONT=behind`: another chat's turn keeps its tab in front; carry on here.
- `window [on|off]` and `proxy [on|off]` set this computer's browser from its next start: [where it shows](references/browser-window.md#where-it-shows), [the proxy](references/browsing.md#the-proxy-setting). With the proxy off, a refused site's steps first name *turn the browser proxy on*.
- *Send me the browser* or *show me the browser*, on every computer: `hand-over.mjs open --view --note "Here is the browser. Tap ✅ at the top right when you're done."`. It holds the chat's tab as the person's turn. With `HANDOVER_VIEW=window`, say the 🔔 tab is in the browser window (on a Mac, *Camoufox* in the Dock if it is behind), and to click ✅ at the top right; on *done* in the chat, run `close`. Never `front` or `show` for this: neither holds a turn.
- `show` brings this task's tab to the front, with no turn, for a finished page only. On `BROWSE_SHOWN=link` or `none`, send a picture instead: [ask for the browser](references/browser-window.md#ask-for-the-browser).
- A box in another site's frame sits at the end of `snapshot`: use its ref, not a selector.
- `save` and `close` keep the logins; `status`, `install`, and `stop` manage the browser. `status` names [the route](references/browser-proxy.md#check-the-live-route) in `BROWSE_NETWORK=`.
- Never ask about a [password manager](references/password-manager.md): 1Password comes by default. Asked to add any add-on: `addon find <name>`; for a `BROWSE_ADDON_BUILT_IN` match, say it is built in and add nothing; for one in `addon status`, say so. One clear match, featured or 10,000+ daily users: name its maker, website, and daily users, and `addon add <slug>` at once; else name the matches' facts, with any `BROWSE_ADDON_WARN`, and add on a yes. Never send them to the add-on site. After an add, tell them its `BROWSE_ADDON_TELL`; for a password manager, `addon open`, then send the browser to sign in to it.
- **Sign in with 1Password** at every login, before any sign-in turn: `addon logins`; for a passkey, after the site's passkey button. For each `BROWSE_ADDON_LOGIN=<n> | <name>` line, `passkey:` ones too, ask every time, as a multiple choice in the chat, with the question tool when there is one: the login, the site, and your numbered steps once signed in. Only on a yes: `addon pick <n>`, click sign-in after a fill, and do only those steps; any other step, or outward action, needs its own yes. The end report names the steps done. On `locked`, `none`, no password manager, or a no: `addon open`, then a sign-in turn; the first for 1Password advises an 8-hour auto-lock. A refused pick: `addon logins` again.
- An add-on's box over the page, not a passkey box, or a refusal naming one: `addon close` at once, no ask; report it closed, saving nothing. On its refusal, a live view. Never click, read, type into, or unlock an add-on otherwise.
Preview checks stay on [agent-browser](https://github.com/matthewwong525/WongStack/blob/main/.agents/skills/agent-browser/SKILL.md).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |