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/password-manager.md
View on GitHub# Your password manager in the browser
The agent's browser comes with the 1Password add-on, and can hold any other add-on, such as Bitwarden or Dark Reader. You sign in to 1Password once and keep it unlocked; the agent then asks you before each sign-in with a login from it, and never unlocks it.
## Ask the agent
The agent asks nothing about a password manager: a new browser adds 1Password with [the checks](#the-checks), and an older one gets it once, at its next start. It is not added when you removed it, said no to a password manager before, or when the agent already added another one. A failed download keeps the start going, and a start a day later tries again.
When you want an add-on, say so: *add my password manager*, or *add Dark Reader*. The agent adds a well-known one at once, with [the checks](#the-checks), and opens a password manager's sign-in page, so you only sign in. An add-on the browser already has, such as uBlock Origin, is built in: the agent says so and adds nothing. A built-in add-on works on every page, but its button sits in the puzzle-piece menu at the right of the toolbar, not on the toolbar.
Ask the agent, not the add-on site in the browser. 1Password added from [Firefox's add-on site](https://addons.mozilla.org) in Camoufox 158.0.1-beta.41 opened no setup page, and its button did nothing; the copy the agent added worked. When you ask the agent for an add-on you already added yourself, its add removes your copy and its stored data, so only the working copy loads.
An add-on you add yourself stays from start to start, but it is not promised to work, and it does not update itself: Camoufox turns add-on updates off. The agent's guard covers every add-on, whoever added it: see [use it at a sign-in](#use-it-at-a-sign-in).
## The checks
[`addons.mjs`](../scripts/addons.mjs) does each step, through `browse.mjs addon <verb>`. The agent never sends you to the add-on site to add it yourself. An add-on can read every page of a browser signed in as you, so a look-alike is a real risk.
- **Firefox's add-on site only.** `addon find <name>` lists up to three extensions from [addons.mozilla.org](https://addons.mozilla.org), each with its maker, website, daily users, and whether Mozilla features it.
- **Your ask is your yes for a well-known one.** When one add-on fits your words, and Mozilla features it or 10,000 or more people use it each day, the agent names its maker, website, and daily users, and adds it at once. When the agent already added it, it says so and adds nothing.
- **It asks first for a doubtful match.** When your words fit more than one add-on, the agent names the matches and adds the one you pick. It warns you and waits for your yes when an add-on is not featured and has under 10,000 daily users: on 2026-11-05 every big manager had more than 67,000, and a look-alike had 4.
- **The file must match.** `addon add <slug>` refuses a download whose sha256 fingerprint is not the one the site gives.
- **Side by side.** A new add-on joins the others. The same add-on again replaces only its own copy.
An add stops the browser, and the next command starts it with the add-on. While a live view is open in any chat, the add stops at once and changes nothing: the agent tries again once the view closes.
Right after it adds a password manager, the agent opens its own page and [sends you the browser](browser-window.md#ask-for-the-browser). You sign in to it there: that is your only step.
## Use it at a sign-in
When a site needs a login or a passkey and 1Password is unlocked, the agent signs in with it, after your yes:
1. `addon logins` reads only the names of the logins 1Password offers for the site. When its list does not open by itself, it clicks 1Password's icon in the login box. For a passkey, the agent first presses the site's passkey button; `addon logins` then reads the names in 1Password's *Sign in with a passkey* box.
2. The agent asks you, every time: the login or passkey, the site, and the numbered steps it will take once signed in.
3. On your yes, `addon pick <n>` picks that login, once. 1Password fills the page, and the agent clicks the site's sign-in. It sees the password box only as filled. For a passkey, it presses that box's sign-in once.
4. The agent does only the steps you said yes to. Another step asks again, and an action that sends, pays, or posts keeps its own yes. Its end report names the steps it did.
A pick needs a fresh `addon logins` on the same page, within 2 minutes; the code refuses any other order. When 1Password is locked, has no login for the site, or you say no, you sign in yourself in a sign-in turn, as below. A passkey on your own phone or computer stays yours: [steps to finish it yourself](browsing.md#steps-for-you-to-finish).
1Password's own boxes over the page, such as *Save login?*, the agent closes at once with `addon close`, with no ask. It presses only the box's own close button, by its name (*Close*, *Dismiss*, *Not now*, or *No thanks*), so nothing goes into your vault and no setting changes; never *Save*, *Update*, or *Never*. A box with no such button stays: you close it in a live view.
In [the browser window](browser-window.md#your-turn-in-the-window), use it as in your own Firefox. In a live view, with the one the agent added:
1. The agent runs `addon open` right after it adds a password manager, and before [a sign-in turn](../skills/hand-over/references/live-view.md#sign-in). The password manager's own page opens in the task's tab: the newest one added, else the newest add-on.
2. The agent sends the live view. You sign in to the password manager, or unlock it. The view opens over that page.
3. You press *Back* until the site shows: each of the password manager's own steps takes one press. Then you fill the login from the list the password manager shows in the page. Back on the site, or at the view's end, the page gets its own size again.
On the password manager's page, the page fits your phone or laptop, as a site does, and the view keeps the whole toolbar on the screen.
Each add-on you asked for has its button on the toolbar, from the second start of a new browser. If you pin a built-in add-on's button back, it stays. Its small pop-up also works in a live view: it stays open until you pick from it or tap outside it. Tap its box, then type, such as your password to unlock it ([a pop-up stays open](../skills/hand-over/references/live-view.md#what-the-link-can-do)). On a phone, the view moves the pop-up inside what you see, and shows the whole toolbar.
Apart from the icon, that one pick, and a box's close, the agent's own steps skip the password manager, and every other add-on. `snapshot` leaves out their frames, and a click, typing, a key, or a choice aimed at one stops with `BROWSE_ERROR=that is the password manager's own; the person uses it in the live view`, which names `addon close` while a box of its own shows. While its page shows in the tab, every step but a new address stops the same way, and the agent can not see that page.
## Keep it safe
When it adds an add-on that Firefox's add-on site tags as a password manager, the agent tells you this step: `addon add` prints it as `BROWSE_ADDON_TELL=`. For any other add-on, it says only that the add-on loads from the next start.
- **Set auto-lock to 8 hours**, so one unlock lasts the workday. The agent never unlocks it: a locked vault gives it nothing, so you get a sign-in turn instead. Your yes before each pick is the guard; the agent never reads a password.
## Updates
At a browser start, once a week, each add-on the agent added is checked for a newer version and swapped in by the same checks. A password manager far behind stops working. A failed check keeps the working copy, so a dead network never stops a start.
## Remove or change it
Name the add-on: *remove my password manager*, or *remove Dark Reader*. `addon remove <name>` deletes that add-on and its stored data, so no signed-in session stays, and leaves the others. A removed 1Password stays removed: no later start adds it back, until you ask for it. To change to another password manager, ask for the new one, then remove the old one.
An add-on you added yourself, you remove in the browser's own add-ons page (`about:addons`). The agent's ones, by hand: delete `~/.wong-stack/camoufox/addons/` and `addons.json` with the browser stopped. An answer saved by an older version, *None* included, is ignored.
Part of [browsing](browsing.md), in [the browser module](../README.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 |