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 |
references/browser-window.md
View on GitHub# The browser window
The agent's browser has one window, with a tab for each chat. This page says where that window shows, how your turn happens in it, how you ask for it, and the two settings each computer keeps. It is part of [browsing](browsing.md).
## A tab for each chat
Each chat, and each scheduled run, gets its own tab in the one window, with the same sign-ins. The chats work at the same time, and none waits for another.
- **A new chat opens a tab, not a window.** A blank first tab stays at the left: the browser opens each chat's tab from it, so leave it open. If you close it, the next chat opens one new window, once.
- **Each tab that waits on you shows π.** While a turn is open, the other chats keep reading, typing, clicking, and resizing in their own tabs at once. None of them waits for your turn, and no step is refused because of it. A step that shows its tab, such as a resize, shows it for a moment; then the π tab you were on comes back to the front. Another chat's `front` or `show` prints `BROWSE_FRONT=behind` and leaves your tab in front. A second chat's turn joins yours, in the window or [your live view](../skills/hand-over/references/live-view.md#what-the-link-can-do): its tab gets a π and waits behind until you pick it.
- **A tab closes when its chat is done**, or after 5 minutes unused.
- **An updated browser starts by itself.** When the browser's own scripts change, the running browser stops once no chat has a tab or a turn open in it. The next browser command starts the new code.
[`browser-server.mjs`](../scripts/browser-server.mjs) owns the tabs.
## Where it shows
| Computer | The browser shows |
|---|---|
| A Mac | In a window on your screen |
| A Windows computer | In a window on your screen |
| A Linux computer with a screen | In a window on your screen |
| A Linux computer with the link setting on | On a virtual screen; your turn comes as a [live-view link](../skills/hand-over/references/live-view.md) |
| A Linux server with no screen | On a virtual screen; your turn comes as a live-view link |
- **The window stays shown.** It never hides by itself. You can minimize it or move it like any window.
- **On a Mac, the window may be behind the app you are in.** Then click *Camoufox* in the Dock.
- **Turn the window off** on a computer you don't sit at: say *don't show the browser window*. The agent runs `browse.mjs window off`, which prints `BROWSE_WINDOW=off`. `window on` turns it back on, and `window` alone prints the setting.
- **On Linux, `window off` is the link setting.** The browser then hides on its virtual screen, and your turn comes as a link. On a Mac or Windows computer, `window off` means no window and no link: a step that needs you ends with [steps to finish in your own browser](https://github.com/matthewwong525/WongStack/blob/main/wiki/development/finish-steps.md).
- **A Linux computer has a screen when the browser's start sees one** (`DISPLAY` or `WAYLAND_DISPLAY`). A browser started from a service with neither uses the link. `browse.mjs status` prints which one the running browser took: `BROWSE_SHOWN=window`, `link`, or `none`.
- **A setting takes effect the next time the browser starts.** The agent never restarts a running browser for it: other chats may use it.
## Your turn in the window
Where the browser shows in a window, your turn for [a sign-in, a payment, a robot check, or a stuck step](../skills/hand-over/references/live-view.md#when-it-opens) happens there, with no link:
- **`open --view` takes the same line** as a live view. It puts π in your chat's tab title, brings the tab to the front unless another turn is open, and prints `HANDOVER_VIEW=window` and no `HANDOVER_LINK`.
- **The chat says the line, with *Hand back*, the green check:** *Sign in to Netflix on the π tab in the browser window, then click β
at the top right.* On a Mac it adds: *If it's behind, click Camoufox in the Dock.* A payment still asks [the pay question](../skills/hand-over/references/live-view.md#pay-or-type-a-code) first.
- **It ends on *Hand back* or your *done*, never because the page changed.** *Hand back* ends every open turn and wakes each chat. On *done*, the agent runs `hand-over.mjs close`, which ends this chat's turn as `handed-back`. Then it reads the page afresh. While the turn is open, it sends that tab nothing.
- **With the window off on a Mac or Windows computer**, `open --view` prints `HANDOVER_VIEW=unsupported`, and the step ends with steps for you.
## Ask for the browser
Say *send me the browser* or *show me the browser* at any time to see and use your chat's tab. On every computer, the agent runs the same command:
```bash
node .claude/skills/browser/skills/hand-over/scripts/hand-over.mjs open --view --note "Here is the browser. Tap β
at the top right when you're done."
```
It stays open through every page, as every turn does, for up to 8 hours. It holds your chat's tab as your turn, so no other chat's click takes the window away from you.
- **With a window,** it brings your chat's tab to the front and prints `HANDOVER_VIEW=window`, with no link. The agent tells you the π tab is in front, and to click β
at the top right or say *done* when you are through. On *done*, it runs `hand-over.mjs close`.
- **With the link,** the agent sends a live view of your chat's tab. It ends when you tap *Hand back*, the green check at the top right.
The agent never runs `browse.mjs front` or `show` for this: neither holds a turn, so another chat's click could switch the window to its own tab.
To show you a page when its task is done, with no turn, the agent runs `browse.mjs show`, which brings your chat's tab to the front. It prints `BROWSE_SHOWN=window`, `link`, or `none`; with `link` or `none` there is no window to show, so the agent sends a picture or the view above. While a turn is open, `show` stops with *the person is using the browser*. The agent still sends a link by itself for a sign-in, a payment or a backup code, a robot check, or a stuck step.
## Settings stay on this computer
The window or link setting and [the proxy setting](browsing.md#the-proxy-setting) are in `~/.wong-stack/browser-settings.json`, which only you can read. No repo file holds them, so each computer keeps its own, and a teammate who pulls your repo gets none of yours. Each setting applies to every repo on the computer.
```text
{ "window": true, "proxy": false }
```
`browse.mjs status` prints `BROWSE_WINDOW=` and `BROWSE_PROXY=`, and says when the running browser started with other settings.
Back to [browsing](browsing.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 |