pup-bridge-macos

--- a/README.md+++ b/README.md@@ -1,83 +1,84 @@⋯ 1 unchanged line ⋯  **Pup gives your AI a real browser on your Mac that it drives completely, in the background, signed in as you.** Its windows live in a hidden browser app, so they never cover your work or take focus, and the AI can still open pages, click, type, read, screenshot and record them. Every window shares one profile where your logins accumulate, and pup fills saved passwords for the AI. Ask your AI to "open it in pup" and it does. -Pup for macOS is one small signed program, a universal binary for Apple Silicon and Intel Macs, that [Adom Bridge](https://wiki.adom.inc/adom/adom-bridge) installs and keeps up to date. This page holds its source, its AI skills and its releases. It is open source under the MIT license.+Pup for macOS is one small signed program, a universal binary for Apple Silicon and Intel Macs, that [Adom Bridge](https://wiki.adom.inc/adom/adom-bridge) installs and keeps up to date. This page holds its AI skills and its releases. It is open source under the MIT license; see [Open source](#open-source) for where the code is.  ## Install ⋯ 71 unchanged lines ⋯  ## Open source -The complete source is in this page's **Files** tab: one Rust workspace, with every macOS API kept in a single crate (`rust/host-mac`). Build it with `tools/build.sh <version>`. Issues and ideas are welcome in the **Issues** tab.+Pup for macOS is one Rust workspace, with every macOS API kept in a single crate (`rust/host-mac`), built with `tools/build.sh <version>`. That source is not in this page's **Files** tab yet: the tab holds the skills, the update manifest and this README, and the program itself ships as the release zip on the **Releases** tab. Issues and ideas are welcome in the **Issues** tab.+--- a/skills/pup-settings/SKILL.md+++ b/skills/pup-settings/SKILL.md@@ -1,105 +1,129 @@⋯ 9 unchanged lines ⋯ (`http://127.0.0.1:<port>/dashboard`). Settings persist in `~/.adom/pup-settings.json`. Defaults below are what a fresh Adom user gets. +## Dock identity: `taskbarMode` (3.0.1+)++macOS has no per-window taskbar button: the Dock tile belongs to the browser process. Since 3.0.1+pup brands each browser at launch instead, with the same key as Windows. A change applies the next+time that browser starts.++| Key | Default | What it does |+|---|---|---|+| `taskbarMode` | **tiles** | `tiles` / `aumid`: pup launches Chrome for Testing from a wrapper app named Adom Pup (bundle `inc.adom.pup.browser`) with the Adom Pup icon; a thread's own browser wears that thread's tile. `plain`: stock Chrome for Testing, no wrapper. |+| `macBackground` | **behind** | `behind`: background windows stay on screen behind your work, so they keep painting. `hidden`: the older hide-the-app park. |++**Known issue (adom/pup-bridge-macos#1, 3.0.1):** the Adom Pup wrapper is missing Chrome's privacy+usage strings, so a page that makes Chrome ask macOS for Bluetooth gets the browser killed (SIGABRT /+SIGKILL, namespace TCC). The common trigger is "Sign in with Google", whose passkey step offers a+phone as a security key. Until a fixed build ships:+- do the Google step in the user's real Chrome through the native browser (`nbrowser_*`), or sign in+  to the site with email and password instead of Google; or+- `pup_configure {"taskbarMode":"plain"}`, then let the browser restart. Stock Chrome for Testing+  keeps its usage strings, so macOS asks for Bluetooth instead of killing it. The windows lose the+  Adom Pup Dock icon.++A crash in this state is logged as "the lane browser exited cleanly (exit code 0: its last window+was closed by the user)", so the windows are not restored. Reopen them with `pup_open_window`.+ ## Windows-only keys (stored, but nothing changes on a Mac) -macOS has no per-window taskbar button, so the Windows line's taskbar keys do nothing here:-`taskbarMode`, `taskbarGrouping`, `aumidIconStyle`, `overlayBadges`, `overlaySize`, `aumidIcons`,-`threadTiles`, `aumidShortcut`, `jumpLists` and the `jl*` jump-list tasks, `taskbarActivity` (reads-`off`) and `winAttentionFlash`. `pup_configure` stores them and reports `taskbarSupported:false`,-`platform:"darwin"`. Do not offer them to a Mac user.+The rest of the Windows line's taskbar keys do nothing here: `taskbarGrouping`, `aumidIconStyle`,+`overlayBadges`, `overlaySize`, `aumidIcons`, `threadTiles`, `aumidShortcut`, `jumpLists` and the+`jl*` jump-list tasks, `taskbarActivity` (reads `off`) and `winAttentionFlash`. Do not offer them to+a Mac user.  ## Toolbar extension family: buttons in the browser toolbar ⋯ 80 unchanged lines ⋯ credential store grows over time. Isolation (`isolated:true`) is REASON-GATED (`isolationReason` required) and a non-adom-you window wears the anonymous identity tile so it's visibly not-you. Never log in on an isolated throwaway, the session (and 2FA-remember) won't persist.+