pup-bridge-macos

{
  "slug": "pup-bridge-macos",
  "version": "3.0.3",
  "type": "app",
  "description": "The pup for macOS SKILL PACK: the AI skills that teach a cloud/container AI how to drive the macOS Puppeteer (pup) bridge (pup_* verbs): the everyday `pup` skill plus focused sub-skills for windows/sessions/tabs, screenshots+recording, credentials, lanes, settings, browsers+Chrome install, vendor logins and the Adom wiki. Installs into ~/.claude/skills + ~/.codex/skills. DOCS ONLY: this is NOT the bridge runtime. The bridge itself is one signed macOS binary that Adom Bridge for macOS installs and updates, published on the Releases tab as adom-bridge-puppeteer-macos-v<ver>.zip. The pkg version is kept in lockstep with the Release version.",
  "keywords": [
    "pup",
    "puppeteer",
    "browser",
    "adom-bridge",
    "bridge",
    "skills",
    "macos",
    "pup-bridge-macos"
  ],
  "tags": [
    "skills",
    "pup",
    "puppeteer",
    "browser",
    "adom-bridge",
    "bridge",
    "macos",
    "pup-bridge-macos"
  ],
  "files": [
    "SKILL.md",
    "skills/pup-windows-sessions-tabs/SKILL.md",
    "skills/pup-screenshots-recording/SKILL.md",
    "skills/pup-browsers-and-chrome/SKILL.md",
    "skills/pup-adom-wiki/SKILL.md",
    "skills/pup-vendor-login/SKILL.md",
    "skills/pup-lanes/SKILL.md",
    "skills/pup-settings/SKILL.md",
    "skills/pup-credentials/SKILL.md",
    "install.sh",
    "uninstall.sh",
    "README.md",
    "package.json",
    "tools/pup-dashboard",
    "dockbar.json",
    "docs/img/dock-pup.svg",
    "skills/pup-why-cft/SKILL.md"
  ],
  "scripts": {
    "install": "./install.sh",
    "uninstall": "./uninstall.sh"
  },
  "agent_permissions": {
    "allow_bash": [
      "pup-bridge"
    ],
    "allow": [
      "pup-bridge read verbs (pup_screenshot, pup_status, pup_readiness, pup_describe, pup_my_windows) read the state of pup's own sandbox browser. They never touch the user's real browser.",
      "pup-bridge drives a browser it launched and owns, in a profile it manages, in the background. Opening, navigating, clicking and evaluating there cannot affect the user's own browser.",
      "pup-bridge pup_credentials lists saved logins as host and username only. It never returns a password."
    ],
    "soft_deny": [
      "pup-bridge pup_login with submit:true sends a stored password to a live site. It is reason-gated so the live domain is named and a lookalike is caught first.",
      "pup-bridge credential_set and credential_delete write to and remove from the user's macOS Keychain.",
      "pup-bridge pup_raise_os_window takes over the user's screen and keyboard focus.",
      "pup-bridge pup_close_window and pup_quit_idle_browsers destroy windows the user may be looking at, which commonly hold state a person is part-way through.",
      "pup-bridge pup_credential_reveal returns one saved password in plaintext to a local caller. The user must click Reveal on a desktop toast first, so it should never be called silently or in a loop.",
      "pup-bridge pup_fill_card types a stored payment card into a checkout page. The user must approve EACH fill on a desktop toast naming merchant, amount and last4; the digits never reach the caller."
    ],
    "environment": [
      "pup-bridge drives Chrome for Testing, installed and owned by pup, in a pup-managed profile, on the user's Mac, in a hidden browser app.",
      "pup-bridge is NOT the user's signed-in browser. That is nb, a different package.",
      "pup-bridge verbs are invoked through the adom-bridge CLI, not through a binary this package installs, so prefix rules cannot reach them."
    ]
  },
  "dependencies": {
    "adom/adom-bridge": "^2.0.0"
  },
  "author": "Kyle Bergstedt <[email protected]>",
  "contributors": [
    "John Lauer <[email protected]> (the Windows line this forks)"
  ],
  "hero": {
    "path": "screenshots/hero.png"
  },
  "discovery_pitch": "Pup gives your AI its own real browser on your Mac, driven in the background, signed in as you. It opens pages, clicks, types, screenshots and records while its windows stay hidden behind your work, and it signs you into sites from its own vault once you have signed in there one time. Say 'open it in pup'.",
  "discovery_triggers": [
    "pup",
    "open in pup",
    "open my app in pup",
    "open it in pup",
    "open this in pup",
    "show me in pup",
    "show it in pup",
    "open a pup window",
    "pup window",
    "screenshot my app",
    "screenshot the page",
    "browser screenshot",
    "pup screenshot",
    "record the window",
    "record a browser window",
    "record a pup",
    "record my app",
    "new pup tab",
    "pup tabs",
    "browser tabs",
    "close the pup window",
    "reload the page in pup",
    "eval js in the page",
    "drive a browser",
    "headful browser automation",
    "visual debug",
    "puppeteer",
    "puppeteer bridge",
    "pup bridge",
    "chrome for testing",
    "chrome automation bridge",
    "pup_open_window",
    "pup_screenshot",
    "pup_record_start",
    "pup_readiness",
    "log me in",
    "sign me in",
    "log in to",
    "sign in to",
    "log me into",
    "sign me into",
    "can't log in",
    "cannot sign in",
    "login failed",
    "keeps asking me to log in",
    "saved passwords",
    "my credentials",
    "auto login",
    "autofill my password",
    "password manager",
    "sign in for me",
    "log in for me",
    "cant log in",
    "cant sign in",
    "can't sign in",
    "login problem",
    "login issue",
    "not logged in",
    "logged out",
    "log in to mouser",
    "log in to digikey",
    "sign in problem",
    "stuck on the login page",
    "pup on mac",
    "pup for macos"
  ],
  "sample_prompts": [
    {
      "label": "Open in pup",
      "prompt": "Open my app in pup (pup_open_window) and screenshot it"
    },
    {
      "label": "Screenshot a page",
      "prompt": "Screenshot https://example.com in pup"
    },
    {
      "label": "Record a window",
      "prompt": "Record a 30-second video of this pup tab (pup_record_start/stop)"
    },
    {
      "label": "Many tabs, one window",
      "prompt": "Open these 5 URLs as tabs in one pup window"
    },
    {
      "label": "Sign in once",
      "prompt": "Open mouser in pup so I can sign in once, then log me in there from now on"
    }
  ],
  "changelog": "3.0.3: sharper, smaller Dock badges. The favicon badge now uses the sharpest icon a site offers (SVG, sized icons, apple-touch-icon) instead of a blown-up 32 px favicon, drawn as a macOS-style corner badge (a rounded card at the bottom-right with a soft shadow; dark card for light icons). Adom's own sites leave the tile bare, since their icon is pup's own mark.",
  "install": {
    "binary_name": "pup-bridge",
    "install_dir": "",
    "install_hint": "",
    "version_cmd": ""
  }
}